Heu MCP
HEU Legal e-signature MCP: manage HEU documents and PDFs, prompt signers, download PDFs.
Connector by lucavisconti211-debug · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/lucavisconti211-debug-heu-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 19 read · 6 write · 3 delete
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Python package
Tools by what they do 28
Read from the source code; the running server may list different tools.
Read 19 · Look things up without changing anything.
download_heu_document_pdfdownload_pdf_audit_traildownload_pdf_bundledownload_pdf_documentextract_heu_document_partiesextract_pdf_document_partiesget_heu_documentget_heu_healthget_pdf_documentlist_heu_document_placeholderslist_heu_documentslist_pdf_document_placeholders
Show 7 more tools
list_pdf_document_signer_placeholderslist_pdf_document_signerslist_pdf_documentslocate_pdf_textpreview_pdf_templateread_heu_documentread_pdf_document
Write 6 · Create, change, send or run things.
create_heu_documentcreate_pdf_documentcreate_pdf_document_from_uploadcreate_pdf_templateprompt_heu_document_signatureprompt_pdf_document_signature
Delete 3 · Delete, drop, revoke or wipe things.
cancel_pdf_documentdelete_pdf_templateupdate_pdf_template
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
HEU_API_KEY
Other settings (environment variables or headers).
HEU_BASE_URLHEU_DOWNLOAD_DIR
Files it touches
- Any path the agent passes to its tools
Tools (28)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
cancel_pdf_documentCancel PDF Signature Requestcan change or delete dataAnnulla una richiesta di firma inviata: nasconde il PDF da tutti gli elenchi e invalida l'accesso alla firma, così i firmatari in attesa non possono più firmare. Viene rifiutato con 409 se il documento ha già attività di firma. IMPORTANTE: chiedere SEMPRE conferma esplicita all'utente prima di eseguire.
create_heu_documentCreate and Share HEU DocumentCrea e condivide un nuovo documento HEU partendo da un template esistente. Invia email ai destinatari. IMPORTANTE: chiedere conferma all'utente prima di eseguire.
create_pdf_documentCreate and Send PDF for SignatureCrea e condivide un nuovo PDF firmabile partendo da un template PDF esistente. Richiede signers e (opzionalmente) i valori dei placeholder. Con signature_type='fea' serve avere credito FEA sufficiente. IMPORTANTE: chiedere conferma all'utente prima di eseguire.
create_pdf_document_from_uploadSend PDF for Signature from FileCrea e invia direttamente un PDF firmabile caricando un file locale (max 5 MB), senza passare da un template. Richiede firmatari completi di email, oggetto/corpo email e layout placeholder (opzionalmente precompilati). Il documento viene creato in stato 'to_sign' e i firmatari ricevono subito l'email. Con signature_type='fea' servono crediti FEA sufficienti. SUGGERIMENTO: per posizionare i campi automaticamente, usa PRIMA locate_pdf_text per trovare le coordinate di ancore come 'Firma', i nomi delle parti, ecc. IMPORTANTE: chiedere conferma all'utente (mostrando la mappatura campi proposta) pr…
create_pdf_templateCreate PDF Template from FileCrea un template PDF riutilizzabile caricando un file PDF locale (max 5 MB) con firmatari e placeholder. Ritorna l'ID del nuovo template, utilizzabile come source_document_id in create_pdf_document. Le posizioni dei placeholder sono in percentuale (0-100) con origine in basso a sinistra. PDF ruotati vengono rifiutati. IMPORTANTE: chiedere conferma all'utente prima di eseguire.
delete_pdf_templateDelete PDF Templatecan change or delete dataElimina (nasconde) un template PDF da tutti gli elenchi. I template non vengono mai firmati quindi l'eliminazione è sempre consentita. IMPORTANTE: chiedere SEMPRE conferma esplicita all'utente prima di eseguire.
download_heu_document_pdfDownload HEU Document PDFread-onlyScarica il PDF di un documento HEU e lo salva localmente. Ritorna il path del file. Layout opzionale (codici a 3 cifre della UI HEU).
download_pdf_audit_trailDownload PDF Audit Trailread-onlyScarica l'audit trail (registro delle attività di firma) di un PDF e lo salva localmente. Ritorna il path del file.
download_pdf_bundleDownload PDF Legal Bundleread-onlyScarica il bundle ZIP completo di un PDF (documento + audit trail + artefatti FES) e lo salva localmente. Ritorna il path del file. Utile per archiviazione legale.
download_pdf_documentDownload PDF Documentread-onlyScarica il PDF di un documento caricato (versione firmata se disponibile) e lo salva localmente. Ritorna il path del file.
extract_heu_document_partiesExtract HEU Document Partiesread-onlyEstrae i dati anagrafici delle parti da un documento HEU. Combina i metadati registrati (firmatari, ruoli, stato firma) con dati estratti dal testo del contratto: codice fiscale, P.IVA, codice univoco SDI, email/PEC, luogo e data di nascita, indirizzi, CAP. Pattern ottimizzati per contratti italiani.
extract_pdf_document_partiesExtract PDF Document Partiesread-onlyEstrae i dati anagrafici delle parti da un PDF caricato. Combina i metadati dei firmatari registrati con dati estratti dal testo: codice fiscale, P.IVA, codice univoco SDI, email/PEC, luogo e data di nascita, indirizzi, CAP. Pattern ottimizzati per contratti italiani.
get_heu_documentGet HEU Documentread-onlyDettaglio di un documento o template HEU per ID.
get_heu_healthHealth Checkread-onlyHealth check API HEU. Ritorna { message: 'ok', status: 200 } se operativa.
get_pdf_documentGet PDF Documentread-onlyDettaglio di un PDF documento/template HEU per ID.
Show 13 more tools
list_heu_document_placeholdersList HEU Document Placeholdersread-onlyLista i placeholder di un documento/template HEU (chiavi sostituibili nel testo).
list_heu_documentsList HEU Documentsread-onlyLista documenti/template nativi HEU con filtri opzionali. IMPORTANTE: quando filtri per intervallo di date passa SEMPRE entrambi i parametri 'created_from' e 'created_to' insieme, altrimenti l'API potrebbe non restituire tutti i documenti del periodo. Se vuoi tutti i documenti senza limiti di data, ometti entrambi.
list_pdf_document_placeholdersList PDF Placeholdersread-onlyLista tutti i placeholder/campi di firma di un PDF.
list_pdf_document_signer_placeholdersList PDF Signer Placeholdersread-onlyLista i placeholder/campi di firma di un signer specifico su un PDF.
list_pdf_document_signersList PDF Signersread-onlyLista i firmatari di un PDF.
list_pdf_documentsList PDF Documentsread-onlyLista PDF documenti/template caricati su HEU.
locate_pdf_textLocate Text Positions in PDFread-onlyTrova la posizione esatta di testi dentro un PDF, per posizionare i placeholder di firma automaticamente. Cerca i termini indicati (default: 'firma', 'sottoscri', 'signature', 'per accettazione', 'timbro', 'luogo e data') e ritorna per ogni occorrenza: pagina, coordinate in percentuale (position_x/position_y, origine in basso a sinistra — lo stesso sistema dei placeholder HEU) e il testo della riga. Ritorna anche le dimensioni pagina. Flusso tipico: locate_pdf_text -> proponi la mappatura campi all'utente -> create_pdf_document_from_upload o create_pdf_template. Suggerimento: il campo firma va…
preview_pdf_templatePreview PDF Template Layoutread-onlyScarica un'anteprima annotata di un template PDF: ogni placeholder è disegnato come un riquadro etichettato con tipo e firmatario. Utile per verificare il posizionamento dei campi prima di usare il template. Salva il PDF localmente e ritorna il path. Solo il proprietario del template può usarlo.
prompt_heu_document_signatureSend HEU Signature ReminderInvia un sollecito di firma per un documento HEU. Limite: 1 prompt ogni 24h per documento (altrimenti 429). IMPORTANTE: chiedere conferma all'utente prima di eseguire.
prompt_pdf_document_signatureSend PDF Signature ReminderInvia un sollecito di firma per un PDF. IMPORTANTE: chiedere conferma all'utente prima di eseguire.
read_heu_documentRead HEU Document Textread-onlyLegge il contenuto testuale di un documento HEU senza salvarlo su disco. Scarica il PDF dall'API HEU, ne estrae il testo e lo restituisce direttamente nella risposta — utile per riassumere, cercare clausole, confrontare contratti. Default: tutte le pagine fino a un limite di 100. Per documenti più lunghi usa il parametro 'pages'.
read_pdf_documentRead PDF Document Textread-onlyLegge il contenuto testuale di un PDF caricato senza salvarlo su disco. Scarica il PDF (incluso quello firmato, se disponibile), ne estrae il testo e lo restituisce direttamente nella risposta. Default: tutte le pagine fino a un limite di 100.
update_pdf_templateUpdate PDF Templatecan change or delete dataSostituisce integralmente firmatari e placeholder di un template PDF esistente (l'ID template resta lo stesso). Solo il proprietario; il documento deve essere di tipo 'template'. Placeholder omessi o [] cancella tutti i campi. IMPORTANTE: chiedere conferma all'utente prima di eseguire.
Signals
- Stars
- 1
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 62
- Last commit
- Aug 25, 2026 (2 months ago)
- Last release
- May 4, 2026 (5 months ago)
- Last package publish
- Aug 25, 2026 (2 months ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.lucavisconti211-debug/heu-mcp- Version
- 0.1.2
- Auth
- API key
- Packages
- pypi heu-mcp
- License
- MIT
- Repository
- github.com/lucavisconti211-debug/heu-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Heu MCP. Agent Mart. https://agentmart.dev/connectors/lucavisconti211-debug-heu-mcp (last updated 2026-10-24)