Fedlex-mcp

Provides two complementary layers of access:

- Live SPARQL tools— query the Fedlex SPARQL endpoint in real-time (no local setup beyondnpm run build)
- SQLite-backed tools— fast, offline-capable tools that work against a local database built bynpm run ingest

Experimental project. Not legal advice. Always verify against the official Fedlex source.

These queryhttps://fedlex.data.admin.ch/sparqlendpointdirectly and require no local database.

These work against a local SQLite database built bynpm run ingest. They are faster, work offline, and provide capabilities not available via SPARQL alone.

get_article_citationsis more precise thanget_citations: instead of "Law A cites Law B", it returns "Art. 12 of the Criminal Code cites Art. 3 of the Data Protection Act".

Every tool that takes anidentifieraccepts either:

- AnSR number— e.g."101"(Federal Constitution),"210"(Civil Code),"311.0"(Criminal Code),"220"(Code of Obligations)
- A fullELI URI— e.g."https://fedlex.data.admin.ch/eli/cc/1999/404"

All tools supportlanguage: "fr" | "de" | "it" | "rm"(default:"fr").

2. (Optional) Build the local SQLite database

Required for the SQLite-backed tools. Downloads and parses all HTML legislation from Fedlex (~7,000 laws, typically 15–30 minutes depending on connection):

You can also setFEDLEX_DB_PATHas an environment variable to point the server at an existing database.
- Fetches allConsolidationAbstractentries from SPARQL
- Resolves the latest consolidation and download URLs per law
- Fetches and parses HTML documents to extract article provisions
- Extracts legal definitions and EU cross-references per article
- Rebuilds the FTS5 full-text index
- Fetches article-level citation edges from SPARQL and stores them
- Writes a JSON summary report alongside the database file

Claude Desktop config(~/.claude/claude_desktop_config.json):

{ "mcpServers": { "fedlex": { "command": "node", "args": ["/path/to/fedlex-mcp/dist/index.js"] } } }

To use a pre-built database, addFEDLEX_DB_PATHto the env:

{ "mcpServers": { "fedlex": { "command": "node", "args": ["/path/to/fedlex-mcp/dist/index.js"], "env": { "FEDLEX_DB_PATH": "/path/to/fedlex.sqlite" } } } }

node dist/index.js --http # custom port: PORT=8080 node dist/index.js --http

- GET /sse— SSE stream for MCP clients
- POST /messages?sessionId=<id>— message relay

docker build -t fedlex-mcp . docker run -p 3000:3000 fedlex-mcp

Set the start command tonode dist/index.js --httpand expose port3000(or setPORTenv var).

All tools are also available as plain HTTP GET endpoints under/api/. Useful for browser clients or non-MCP integrations.

GET /api/search?q=<query>&lang=fr&limit=20&in_force=true GET /api/list?lang=fr&limit=50&offset=0&in_force=true GET /api/legislation/:id?lang=fr GET /api/text/:id?lang=fr&format=html&version=2024-01-01 GET /api/versions/:id GET /api/citations/:id?direction=both&lang=fr&limit=50

GET /api/db/search?q=<query>&limit=20&sr=235.1 GET /api/db/definitions?term=<term>&limit=20 GET /api/db/eu-refs?id=2016/679&type=Directive&limit=30 GET /api/db/article-citations?sr=311.0&article=art_1&direction=both&limit=50 GET /api/db/stats

Parameters for/api/db/article-citations:

search_legislation("protection des données") → finds LPD (SR 235.1) and related ordinances get_legislation("235.1") → metadata for the Loi fédérale sur la protection des données get_legislation_text("311.0", language="fr") → full text of the Code pénal suisse get_versions("220") → all historical versions of the Code des obligations get_citations("101", direction="from", language="fr") → all laws that cite the Constitution fédérale search_legislation("Datenschutz", language="de") → same search in German

search_provisions("données personnelles sensibles", sr_number="235.1") → FTS5 search within the LPD for that phrase lookup_definition("personne concernée") → all formal definitions of that term across Swiss federal law find_eu_references(eu_identifier="2016/679") → Swiss laws referencing the GDPR get_article_citations("311.0", article_id="art_12", direction="both") → articles that Art. 12 CP cites, and articles in other laws that cite Art. 12 CP get_db_stats() → total counts of laws, provisions, definitions, EU references, article citations

All data comes from the Swiss Federal Chancellery'sFedlex platformvia:

- SPARQL endpoint:https://fedlex.data.admin.ch/sparqlendpoint
- Ontology:JOLux(based on FRBR, ELI)
- Formats available: PDF, HTML, XML (Akoma Ntoso, since 2022), DOCX
- Coverage: All Classified Compilation (RS/SR) texts — acts, ordinances, regulations, treaties

A modular server providing unified access to multiple astronomical datasets, including astroquery services and DESI data sources.