heu-legal-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HEU_API_KEY | Yes | API key HEU Legal (richiesto) | |
| HEU_BASE_URL | No | URL base API | https://api.heulegal.com/v1 |
| HEU_DOWNLOAD_DIR | No | Cartella dove salvare i PDF scaricati | /tmp |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_heu_healthA | Health check API HEU. Ritorna { message: 'ok', status: 200 } se operativa. |
| list_heu_documentsA | Lista 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. |
| get_heu_documentC | Dettaglio di un documento o template HEU per ID. |
| list_heu_document_placeholdersB | Lista i placeholder di un documento/template HEU (chiavi sostituibili nel testo). |
| create_heu_documentB | Crea e condivide un nuovo documento HEU partendo da un template esistente. Invia email ai destinatari. IMPORTANTE: chiedere conferma all'utente prima di eseguire. |
| prompt_heu_document_signatureA | Invia 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. |
| extract_heu_document_partiesB | Estrae 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. |
| read_heu_documentA | Legge 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'. |
| download_heu_document_pdfA | Scarica il PDF di un documento HEU e lo salva localmente. Ritorna il path del file. Layout opzionale (codici a 3 cifre della UI HEU). |
| list_pdf_documentsC | Lista PDF documenti/template caricati su HEU. |
| get_pdf_documentC | Dettaglio di un PDF documento/template HEU per ID. |
| list_pdf_document_signersB | Lista i firmatari di un PDF. |
| list_pdf_document_signer_placeholdersA | Lista i placeholder/campi di firma di un signer specifico su un PDF. |
| list_pdf_document_placeholdersC | Lista tutti i placeholder/campi di firma di un PDF. |
| create_pdf_documentA | Crea 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. |
| extract_pdf_document_partiesA | Estrae 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. |
| read_pdf_documentA | Legge il contenuto testuale di un PDF caricato senza salvarlo su disco. Estrae il testo dal PDF e lo restituisce direttamente nella risposta. Default: tutte le pagine fino a un limite di 100. Nota: usa lo stesso endpoint di download dei documenti HEU; se l'API non lo supporta per i PDF caricati, restituirà un errore esplicito. |
| prompt_pdf_document_signatureA | Invia un sollecito di firma per un PDF. IMPORTANTE: chiedere conferma all'utente prima di eseguire. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lucav21/heu-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server