norm-mcp
The server exposes five MCP tools to read, verify, link, and search Italian legal norms from Normattiva.it, with built-in network safeguards and local cached state.
normattiva_leggi_articolo: read the verified text of an Italian law article by source name (or alias) and article number; optional historical date (vigenza).normattiva_link: generate a Markdown citation[text](permalink)for an article, optionally verifying that the URN is valid.normattiva_trova_fonte: search the local verified table of legal sources by name or alias without making network requests.normattiva_leggi_urn: read the text for an already-known Normattiva URN, e.g. a normative reference found inside another article.normattiva_stato_rete: inspect local protection state such as cache, quotas, cooldown, and last incident without touching the network.All tools include conservative network usage: shared SQLite cache, rate limiting, cooldowns, offline mode, and protective status in responses; historical/abrogated/preambolo results are clearly flagged.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@norm-mcp Leggi l'articolo 2043 del codice civile"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
normattiva-mcp
CLI e server MCP per leggere, verificare e citare norme italiane da Normattiva.it, pensati per essere usati anche da modelli LLM economici (es. DeepSeek 4 flash). Il testo di un articolo viene sempre dall'API di Normattiva, mai dal permalink del portale (2.000 volte più pesante per lo stesso contenuto — vedi ARCHITETTURA.md).
Cosa fa
Da terminale (norm --help):
norm leggi <fonte> <articolo>— legge il testo verificato di un articolo (norm leggi "codice civile" 2043)norm link <fonte> <articolo>— costruisce la citazione Markdown, verificandola per difettonorm urn <urn>— legge un URN già in mano (es. un rinvio trovato in un testo)norm fonti [testo]— elenca le fonti verificate, o ne cerca unanorm doctor— controlla se l'endpoint del testo rispondenorm stato— mostra localmente cache, quote, cooldown e ultimo incidentenorm skill— installa e aggiorna la skill Agent Skills per gli assistentinorm verifica --tutte— mostra prima il costo stimato; esegue solo con--esegui, dopo avere prenotato tutto il budget necessario
Come server MCP (norm-mcp), cinque strumenti:
normattiva_leggi_articolo— stessa lettura dinorm legginormattiva_link— stessa citazione dinorm linknormattiva_trova_fonte— cerca una fonte nella tabella, nessuna retenormattiva_leggi_urn— stessa lettura dinorm urnnormattiva_stato_rete— stato locale della protezione, senza rete
Una futura ricerca full-text non è ancora esposta: se verrà aggiunta, dovrà usare solo un canale Open Data ufficiale adatto al volume richiesto.
Related MCP server: Italian Law MCP
Installazione
Richiede uv e Python 3.12-3.14.
uv tool install --editable .Installa entrambi i comandi (norm, norm-mcp) in ~/.local/bin, restando
sincronizzati col sorgente (utile durante lo sviluppo; per un uso normale
basta uv tool install normattiva-mcp una volta pubblicato su PyPI).
Collegare il server MCP a un assistente
Esempio per Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"normattiva": {
"command": "/Users/tuonome/.local/bin/norm-mcp",
"args": []
}
}
}Riavvia l'app dopo aver modificato il file. Il server parla solo su stdio, nessuna porta di rete aperta.
Installare la skill Agent Skills
La skill portabile normattiva-mcp segue lo
standard aperto Agent Skills e non contiene estensioni
specifiche di un singolo modello. È inclusa anche nel pacchetto Python, così la CLI
può installarla dopo un'installazione da PyPI, uv tool o pipx.
norm skill list
norm skill install opencode
norm skill install claude-code
norm skill install codex
norm skill install pi
norm skill install allinstall all installa soltanto nei client rilevati tramite il loro binario o la
directory di configurazione e indica quelli saltati. Indicando un client preciso,
l'installazione viene invece eseguita anche se il relativo binario non è sul PATH.
Il livello predefinito è personale. Per installarla solo nel progetto corrente:
norm skill install opencode --level projectLe destinazioni sono quelle native dei client: ~/.claude/skills,
~/.agents/skills, ~/.config/opencode/skills e ~/.pi/agent/skills; a livello
progetto diventano rispettivamente .claude/skills, .agents/skills,
.opencode/skills e .pi/skills. norm skill update aggiorna le copie già
installate, norm skill show mostra la sorgente e norm skill uninstall <client>
la rimuove dal client indicato.
Per collaudare un modello, il protocollo incluso parte da operazioni locali, usa al
massimo un canary reale e richiede che la ripetizione identica sia servita dalla
cache. Gli errori e l'arresto su critico/bloccato vanno provati solo con mock o
server locale.
Uso prudente della rete
Avvertenza: osservazioni empiriche indicano che, dopo un numero elevato di richieste, Normattiva.it può smettere di rispondere in modo persistente da uno specifico indirizzo IP pur restando raggiungibile da altre reti. Non vi è una conferma ufficiale che si tratti di un ban, e sintomi analoghi possono dipendere anche da filtri o problemi di instradamento. Considerare comunque concreto il rischio: usare l'MCP con parsimonia, evitare raffiche e parallelismo e fermarsi al primo errore o cooldown senza tentare di proseguire tramite altre reti.
Il programma usa soltanto l'endpoint Open Data documentato POST .../atto/dettaglio-atto-urn, mai scraping HTML, browser automation, proxy
o cambio di IP/VPN. Il permalink è generato come link, ma non viene scaricato.
Un database SQLite condiviso coordina CLI, MCP e processi concorrenti: una
sola richiesta reale alla volta, almeno 5 secondi fra richieste e cache
condivisa. Il testo vigente resta in cache 7 giorni, quello storico 30;
gli errori deterministici 400/404 un'ora. NORMATTIVA_OFFLINE=1 usa solo
la cache; se il database protettivo non è disponibile, non viene inviata
nessuna richiesta.
I limiti seguenti sono cautele locali del progetto, non limiti comunicati da Normattiva: 30 consultazioni e 2 diagnosi per 24 ore mobili, con un massimo assoluto di 60. Si possono solo ridurre con le variabili d'ambiente; non aumentare da flag CLI o tool MCP. Ogni tentativo HTTP, anche fallito, consuma quota e non esistono retry automatici.
Configurazione facoltativa: NORMATTIVA_STATO_DB sceglie il file SQLite;
NORMATTIVA_OFFLINE=1 disabilita la rete; NORMATTIVA_LIMITE_CONSULTAZIONI,
NORMATTIVA_LIMITE_DIAGNOSI e NORMATTIVA_LIMITE_ASSOLUTO possono soltanto
ridurre le rispettive soglie. NORMATTIVA_CONTATTO_USER_AGENT aggiunge un
contatto volontario al User-Agent stabile del progetto.
Un 429 comporta il rispetto di Retry-After e comunque almeno 6 ore di
pausa; 401/403/409 24 ore; 5xx o risposta malformata 15 minuti. Timeout,
reset e TLS sono eventi indeterminati, non prova di ban, e avviano un
cooldown crescente. Durante il cooldown, avvisa l'utente e non ritentare:
non cambiare IP, VPN o proxy per proseguire.
Ogni risposta MCP che può usare la rete include protezione_rete; la CLI
scrive il consumo reale su stderr (per esempio consultazione 7/30 — totale 9/60). A 50%, 80% e 90% il livello diventa rispettivamente attenzione o
critico. Quando è critico o bloccato, il modello deve fermare il workflow
e avvertire l'utente. Prima di un'attività con più consultazioni, usa
norm stato o normattiva_stato_rete.
norm doctor non esegue rete durante un cooldown e fa al massimo una
richiesta. La verifica completa è limitata a una ogni 7 giorni e parte solo
se il budget intero è prenotabile. Prima di aumentare i volumi o offrire il
servizio a terzi, chiedere al gestore indicazioni scritte su limiti, canale
bulk e modalità d'uso preferite. Future operazioni massive devono usare solo
eventuali canali ufficiali asincroni/bulk, mai un fan-out articolo per articolo.
Documentazione
CLAUDE.md — mappa del progetto, regole vincolanti
ARCHITETTURA.md — come è fatto e perché
Licenza
Il codice di questo repository è distribuito con licenza MIT (vedi LICENSE).
I dati restituiti dagli strumenti (testi normativi, metadati degli atti) provengono da Normattiva.it, Istituto Poligrafico e Zecca dello Stato, e sono distribuiti con licenza Creative Commons Attribuzione 4.0 Internazionale (CC BY 4.0). Ogni risposta degli strumenti include l'attribuzione richiesta dalla licenza.
Available Tools
5 toolsnormattiva_leggi_articoloLeggi il testo verificato di un articoloARead-onlyIdempotent
Legge un articolo dato nome o alias della fonte (es. codice civile, l.fall.) e numero, anche con estensione ("21novies"). Per i codici storici è la via affidabile: usa prima normattiva_trova_fonte se l'alias non è certo. Controlla sempre esito: preambolo non è l'articolo; abrogato è informazione; vigenza_storica indica testo non vigente. vigenza (YYYY-MM-DD) chiede una data storica.
Inputs: fonte (required), articolo (required), vigenza. Returns: Schema comune per articolo, abrogato e preambolo.
normattiva_leggi_urnLeggi un URN Normattiva già disponibileARead-onlyIdempotent
Legge un URN completo ottenuto altrove. Verifica esito: anche una risposta 200 può essere un preambolo; abrogato e vigenza_storica non sono diritto vigente. Per fonte più articolo usa normattiva_leggi_articolo, che passa dalla tabella verificata.
Inputs: urn (required). Returns: Schema comune per articolo, abrogato e preambolo.
normattiva_linkCostruisci la citazione Markdown di un articoloARead-onlyIdempotent
Costruisce [testo](permalink) senza il testo integrale. Per difetto verifica=true consulta l'API: il permalink può rispondere 200 anche a un URN sbagliato. verifica=false è locale e non prova esistenza o vigenza; restituisce comunque lo stato locale di protezione. Non ignorare avvisi su abrogato o preambolo.
Inputs: fonte (required), articolo (required), vigenza, verifica. Returns: avvisi, avviso, markdown, verificato, +1 more
normattiva_stato_reteMostra stato locale di quota, cache e cooldownARead-onlyIdempotent
Non usa la rete. Mostra rapporto di protezione e aggregati giornalieri (richieste reali, cache hit, errori, densità e cooldown). Usalo prima di un'attività con più consultazioni.
Inputs: no named parameters. Returns: rapporto, aggregati_giornalieri
normattiva_trova_fonteCerca una fonte nella tabella verificataARead-onlyIdempotent
Cerca nome o alias nella tabella locale: tipo, data, numero, allegato e stato, senza rete. Usalo prima di un codice storico: un allegato indovinato può puntare a un atto diverso. Una fonte assente qui non è assente dall'ordinamento.
Inputs: testo (required). Returns: data, nota, tipo, alias, +7 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a distinct job: source lookup, article read, URN read, permalink construction, and network status. The only mild overlap is between normattiva_leggi_articolo and normattiva_leggi_urn, but the descriptions clearly separate them by input type.
All tool names share the normattiva_ prefix and use snake_case, with several following an action-first pattern like normattiva_leggi_articolo and normattiva_trova_fonte. normattiva_link and normattiva_stato_rete deviate slightly from the verb_noun style, but the overall pattern is still recognizable and predictable.
Five tools is a tight, well-scoped count for a Normattiva citation and retrieval server. Each tool contributes a distinct capability and none feels redundant or missing from the core workflow.
The set covers the main workflow: finding a source, reading an article, resolving a URN, generating a permalink, and checking network status. A full-text search or article-list endpoint would be a useful addition, but the current surface is functional for citation-oriented tasks with no hard dead ends.
Maintenance
Related MCP Connectors
Resolve, search and verify legal citations against the official sources, with provenance.
Official MCP connector for Legalize: read and search its whole open corpus, at any point in time.
Japan Law MCP — Japanese national laws & ordinances via the e-Gov Law API.
Italian administrative courts MCP -- search and read the published rulings of the Consiglio di…
Related MCP Servers
- AlicenseAqualityFmaintenanceEnables querying over 3,200 Dutch statutes (AVG, Wetboek van Strafrecht, Burgerlijk Wetboek, etc.) with verbatim, citation-grounded text from official sources, directly from MCP-compatible AI assistants.1849 npm15Apache 2.0
- AlicenseNot gradedqualityFmaintenanceMCP server for Italian law – indexes statutes from Normattiva such as Codice Civile, Codice Penale, and more, with EU implementation mapping.52 npm1Apache 2.0
- AlicenseAqualityBmaintenanceAn MCP server for Italian law, enabling live access to legislation via Normattiva and case law from the Constitutional Court, Supreme Court, and administrative courts, with citation verification.1460 PyPIApache 2.0
- AlicenseBqualityBmaintenanceEnables querying Italian and EU law, case law, parliamentary data, open data portals, Eurostat statistics, PNRR projects, and migrant reception centers through 24 MCP tools, with citation-grounded legal answers.24Apache 2.0