Fedlex Connector

ch.fedlex-connectorPublished by fedlex-connector.chOfficial publisherv1.0.0Updated Oct 24, 2026

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Remote MCP server that lets an assistant search and read official Swiss federal legislation from Fedlex, including laws, articles and amendment dates.

What you can do
  • Search act titles in the Classified Compilation (RS/SR) to find an RS number
  • Fetch the consolidated text of an act or a specific title/chapter, with pagination for large acts
  • Retrieve a single article by RS number and exact article number, optionally at a past consolidation date
  • List consolidation version dates and recent amendments for an act
  • Results are available in German, French and Italian
When to use it
Useful when answering questions about Swiss federal law and you want the text pulled from the official Fedlex source rather than from memory or general web pages, which the Fedlex single-page frontend does not render well. Also handy for checking which version of an act was in force on a given date.
Requirements
A remote MCP endpoint; no package, account, API key or environment variable is declared. The server itself calls the public Fedlex SPARQL endpoint and HTML filestore, so it needs network access to those Swiss government services.
Before you install
Read-only lookups; no data is written or sent to third parties beyond requests to Fedlex. Coverage is limited to federal law in the Classified Compilation: cantonal law, the Federal Gazette and court decisions are out of scope, and Romansch is not supported. Full-act text is only available as currently in force, and HTML exists mainly for consolidations from 2021 onwards. Responses note that only the Official Compilation published by the Federal Chancellery is legally authoritative.

Installation

In SourceWeft

  1. Open Fedlex Connector in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ch.fedlex-connector%2Ffedlex-connector/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "fedlex-connector": {
      "type": "http",
      "url": "https://mcp.fedlex-connector.ch/"
    }
  }
}

README

Fedlex Connector

Access Swiss Federal Law from Claude

A connector that gives Claude direct access to the official text of Swiss federal legislation on Fedlex, built on the Model Context Protocol (MCP). Covers all acts in the Classified Compilation (SR, RS) in German, French, and Italian.


Why This Exists

Swiss federal law is published exclusively on Fedlex, but the frontend is a JavaScript single-page application that Claude's built-in web tools cannot render. However, Fedlex exposes two machine-readable interfaces that work without JavaScript:

  • A SPARQL endpoint (fedlex.data.admin.ch/sparqlendpoint) for metadata queries
  • A static HTML filestore (fedlex.admin.ch/filestore/...) serving consolidated legislation

This MCP server bridges the gap: it queries SPARQL for metadata (RS numbers, consolidation dates, amendment history), fetches and parses the HTML for the actual legislative text, and returns it to Claude in a structured format. No proprietary database, no cache -- just a stateless bridge to Fedlex's open data infrastructure.


Setup

The server supports two transports: stdio for local use (Claude Code, Claude Desktop) and HTTP for remote use (claude.ai). You can use one or both.

The server is hosted at:

https://mcp.fedlex-connector.ch

claude.ai / Claude Desktop:

  1. Go to claude.ai
  2. Click Customize (Anpassen / Personnaliser / Personalizza) in the sidebar
  3. Click Connectors
  4. Click + → Add connector
  5. Click Add custom connector and paste the URL: https://mcp.fedlex-connector.ch

We suggest naming it "Fedlex Connector".

Claude Code:

bash
claude mcp add --transport http fedlex https://mcp.fedlex-connector.ch

Once connected, Claude can answer questions like "What does art. 1 of the Swiss Civil Code say?" by pulling the text directly from Fedlex.

Deploying Your Own Instance

The server includes a Dockerfile for deploying to any cloud platform that supports Docker containers (Railway, Fly.io, Render, etc.). Set the PORT environment variable and the server runs in HTTP mode. Without PORT, it runs in stdio mode for local use.

Your MCP endpoint will be at https://your-domain. Verify with:

bash
curl https://your-domain/health

Tools

search_by_title

Search Swiss federal legislation titles in the Classified Compilation (RS/SR). Returns only acts currently in force.

ParameterTypeRequiredDescription
querystringYesKeywords to match against act titles
languagefr de itNoLanguage for results (default: de)

Example: Find the RS number for the data protection act.

search_by_title(query="protection des données")→ RS 235.1 — Loi fédérale sur la protection des données (LPD)

get_article

Retrieve the official consolidated text of a specific article.

ParameterTypeRequiredDescription
rs_numberstringYesRS number (e.g. "210" for CC, "220" for CO)
articlestringYesArticle number (e.g. "3", "28a", "260bis")
languagefr de itNoLanguage (default: de)
datestringNoConsolidation date (YYYY-MM-DD); defaults to latest

Example: Retrieve art. 1 CC in German.

get_article(rs_number="210", article="1", language="de")→ Art. 1: Das Gesetz findet auf alle Rechtsfragen Anwendung...

get_law_text

Retrieve the full text of an act or a specific title/chapter. This is the primary tool for reading and analysing legislation from the source.

ParameterTypeRequiredDescription
rs_numberstringYesRS number
sectionstringNoLimit to a title/chapter (e.g. "Titre huitième")
languagefr de itNoLanguage (default: de)
pagenumberNoPage for paginated results (default: 1)

Large acts are paginated automatically (splitting at article boundaries). Each response includes the total page count.

Example: Retrieve Swiss tenancy law (CO, Title 8).

get_law_text(rs_number="220", section="Titre huitième", language="fr")→ [Full text of tenancy provisions, art. 253 onwards]

list_amendments

List recent amendments (consolidation versions) for a given act.

ParameterTypeRequiredDescription
rs_numberstringYesRS number
sincestringNoStart date, YYYY-MM-DD (default: 1 year ago)
languagefr de itNoLanguage for titles (default: de)

Example: Check recent changes to the CO.

list_amendments(rs_number="220", since="2024-01-01")→ 2026-01-01 — Version in force from 2026-01-01 (current)  2025-10-01 — Version in force from 2025-10-01 to 2025-12-31  ...

How It Works

Claude  ──MCP──>  Fedlex Connector  ──SPARQL──>  fedlex.data.admin.ch                                      ──HTTP───>   fedlex.admin.ch/filestore/...

Metadata path (SPARQL): The server queries Fedlex's SPARQL endpoint (JOLux ontology) to resolve RS numbers to internal URIs, find the latest consolidation date, discover HTML file URLs, and list amendment history.

Text path (HTML filestore): Once the server knows which HTML file(s) to fetch, it retrieves them from the static filestore, parses the DOM with Cheerio, and extracts the requested article, section, or full text. Large acts (like the CO with 1,100+ articles) are split across multiple HTML files which the server discovers and stitches together automatically.

Data flow for a typical request:

  1. Claude calls get_article(rs_number="210", article="3")
  2. Server queries SPARQL: RS 210 → ConsolidationAbstract URI
  3. Server queries SPARQL: latest consolidation date for that URI
  4. Server queries SPARQL: HTML filestore URL(s) for that consolidation
  5. Server fetches HTML, parses it, extracts art. 3
  6. Server returns the article text to Claude with consolidation date and legal caveat

Every response includes a footer noting that only the Official Compilation (RO/AS) published by the Federal Chancellery is legally authoritative.


Development

Project Structure

src/  index.ts       # Entry point: picks stdio or HTTP transport based on PORT env var  server.ts      # MCP server factory: tool definitions and request handlers  types.ts       # TypeScript interfaces, error types, constants  sparql.ts      # SPARQL endpoint queries (metadata, RS resolution, amendments)  filestore.ts   # HTML fetching, parsing, article/section extraction, paginationbuild/           # Compiled JavaScript (generated by tsc)Dockerfile       # Container build for cloud deployment

Scripts

CommandDescription
npm run buildCompile TypeScript to ./build
npm startRun the MCP server (stdio mode)
npm run start:httpRun locally in HTTP mode on port 3000
npm run devWatch mode (auto-recompile on changes)

Dependencies

PackagePurpose
@modelcontextprotocol/sdkMCP server SDK (tool registration, stdio transport)
cheerioHTML parsing for extracting legislative text

Error Codes

The server returns structured errors with codes and actionable suggestions:

CodeMeaning
RS_NOT_FOUNDRS number not found in the SPARQL graph
ARTICLE_NOT_FOUNDArticle does not exist in the act (with nearby IDs listed)
SPARQL_UNAVAILABLESPARQL endpoint is down or returned an error
FILESTORE_ERRORHTML file not found or fetch failed
INVALID_INPUTMissing or malformed parameters
PARSE_ERRORHTML parsing failure

Known Limitations

  • Full act historical versions: get_law_text only retrieves full acts as they are currently in force and does not return past versions. For historical text, use get_article, which supports a date parameter.

  • HTML availability: Fedlex generally only provides HTML for consolidations from 2021 onwards. Older versions are only available as PDF or DOC on the Fedlex platform. The server returns a clear error with guidance when HTML is unavailable for a requested date.

  • Rate limiting: The SPARQL endpoint and filestore are public Swiss government services. The server limits itself to 10 requests/second per endpoint to be a responsible client.

  • Section filtering: The section parameter in get_law_text uses heading-text matching which works well for standard section names but may not match unusual headings. When filtering fails, the full act text is returned with a note.

  • Language coverage: Supports French (FR), German (DE), and Italian (IT). Romansch is not available.

  • Scope: Covers federal law in the Classified Compilation only. Cantonal law, the Federal Gazette, and court decisions are out of scope.


License

MIT

Source: README.md at commit 810e953

Tools

4

search_by_title

Search Swiss federal legislation titles in the Classified Compilation (RS/SR) on Fedlex. Use to find the RS number of a law when you know its name but not its number. Searches titles only, not article content. Returns only acts currently in force.

Parametersqueryrequiredlanguage

get_article

Retrieve a single article when you already know the EXACT article number (e.g. from a cross-reference). Do NOT call this tool repeatedly to search for provisions — use get_law_text instead to fetch the full act or a section and locate relevant articles in the text.

Parametersdatearticlerequiredlanguagers_numberrequired

get_law_text

Retrieve the official consolidated text of a Swiss federal act (or a specific title/chapter) directly from Fedlex (fedlex.admin.ch). This is the PRIMARY tool for answering Swiss law questions — always start here. Fetch the full act or a specific section, then locate relevant provisions in the returned text. Prefer this over get_article unless you already know the exact article number.

Parameterspagesectionlanguagers_numberrequired

list_amendments

List consolidation version dates for a Swiss federal act. Returns the dates each consolidated version took effect.

Parameterssincelanguagers_numberrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts