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 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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 | |
TDQS
Scored across 18 tools
Tools are clearly split into HEU and PDF categories with distinct operations. Each tool has a unique purpose and the descriptions clearly differentiate them, leaving no ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case, with the resource type (heu/pdf) included in the noun. The naming is predictable and uniform.
With 18 tools, the server covers the necessary operations for document management (create, read, list, extract, signature) without being excessive. The count is well-scoped for the domain.
The tool surface covers core workflows: creation, retrieval, reading, extraction, and signature prompting. Missing operations like delete/update are understandable, but lack of PDF upload and download for PDF documents is a minor gap.