normattiva-mcp
English · Italiano
A lightweight Model Context Protocol server that exposes the Normattiva OpenData API — the official Italian legislation portal run by IPZS — to LLM clients like Claude Desktop, Cursor, and Claude Code.
Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
English · Italiano
A lightweight Model Context Protocol server that exposes the Normattiva OpenData API — the official Italian legislation portal run by IPZS — to LLM clients like Claude Desktop, Cursor, and Claude Code.
MCP server for the Normattiva Italian legislation API
It wraps the synchronous read endpoints (search, article detail, recent updates) and the static reference catalogs as MCP tools, resources, and prompts.
Version 0.2.x remains under development and was rolled back after issues were encountered; the currently supported release is v0.1.4.
Run via npx:
npx normattiva-mcp
Add to your MCP client config (claude_desktop_config.json for Claude Desktop, or ~/.claude.json / .mcp.json for Claude Code):
{
"mcpServers": {
"normattiva": {
"command": "npx",
"args": ["-y", "normattiva-mcp"]
}
}
}
In .cursor/mcp.json:
{
"mcpServers": {
"normattiva": {
"command": "npx",
"args": ["-y", "normattiva-mcp"]
}
}
}
The server always talks to Normattiva's production OpenData API (https://api.normattiva.it/t/normattiva.api). The endpoint is hard-coded — there is no environment variable to override it. The PRE/test environment is intentionally not supported because it is mTLS-protected.
The OpenData API is open and does not require authentication.
In addition to the npm-published stdio binary, this repo also ships packages/http-server/ — a Vercel deployment of the same MCP server over the Streamable HTTP transport. Useful for clients that need a remote endpoint instead of a local subprocess.
Hosted endpoint: https://normattiva-mcp.adellorto.com/api/mcp — free, no signup, no auth.
Client config:
{
"mcpServers": {
"normattiva": {
"url": "https://normattiva-mcp.adellorto.com/api/mcp"
}
}
}
To run your own copy on a Vercel account:
git clone https://github.com/adellorto/normattiva-mcp.git
cd normattiva-mcp
pnpm install
cd packages/http-server
npx vercel deploy
The handler exposes only Streamable HTTP (SSE is removed from the 2025-03-26 MCP spec). No authentication by default — anyone with the URL can call it.
Requires Node.js ≥ 20.
git clone <repo>
cd normattiva-mcp
npm install
npm run build
node dist/index.js # speaks MCP on stdio
A live smoke test (hits the public API):
node tests/smoke.mjs
list_articles is a best-effort probe: it calls read_article for articolo=1,2,3,… until it stops finding results. By default it discovers base articles only; include_suffixes: true extends the probe to bis/ter/quater/… (round-by-round, stopping each chain at the first miss) but cannot find sub-articles whose base is missing, nor articles inside structured groups (id_gruppo != 0).id_gruppo is opaque. Some atti — typically structured codes (codici, testi unici, leggi articolate) — return content only when read_article is called with a non-zero id_gruppo. The OpenData API offers no way to discover the right value synchronously. Practical strategy: try id_gruppo=0 first; if results look empty or wrong, try small integers (1, 2, 3, …) until the article comes back.dettaglio-atto endpoint serves one article at a time. read_article exposes that directly (parallelize from the client when reading several articles); read_act hides the orchestration and returns a single aggregated payload, capped by max_chars and resumable via articolo_successivo.format: "text" collapses Normattiva's HTML markup but preserves the Italian-law amendment markers (( ... )) (insertions) and [ ... ] (deletions), which carry semantic meaning. Hyperlinks to other normative acts are inlined as <text> [urn:nir:…] so the Akoma Ntoso URN survives in plain text.read_article call returns the version of the article in force on data_vigenza (the API's versione=0 default). The OpenData API does not expose how many historical versions exist for an article, so previous texts can only be retrieved by varying data_vigenza (or by guessing versione=1, 2, …).is_abrogated is heuristic. The flag matches the canonical ((ARTICOLO ABROGATO …)) marker that successive amendments insert at the head of a wholly-abrogated article. Articles where individual commi are abrogated but the article itself is alive (e.g. ((COMMA ABROGATO …)) in a few subsections) are not flagged.recent_updates treats data_fine as inclusive end-of-day (UTC). The window is capped at 12 months and 7000 atti by the API; both limits surface as IPZS error codes (1501, 1502).This server's source code is MIT — see LICENSE.
Legislative content retrieved through this server is published by IPZS under CC BY 4.0. The server is a pass-through and does not relicense the content: any downstream use or redistribution must attribute Normattiva / IPZS as the source.
Normattiva is a trademark of the Istituto Poligrafico e Zecca dello Stato Italiano (IPZS); this project is not affiliated with or endorsed by IPZS.
MCP server for the Normattiva Italian legislation API
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Normattiva runs locally over stdio.
Last checked 2026-10-27. MCP server for the Normattiva Italian legislation API