Switzerland Parliament Mcp Server

io.github.cyanheadsPublished by GitHub account cyanheadsv0.1.2Updated Nov 2, 2026

Search Swiss parliamentary business, votes, debates, members, and declared interests.

VerifiedStreamable HTTPWeb executableLocation & LifestyleKnowledge & Memory

Overview

AI-generated overview

Read-only MCP access to Swiss parliamentary records: business, Nationalrat roll calls, debate transcripts, members and declared interests.

What you can do
  • Search and read parliamentary business, including original texts, status history, bills, related business and debate subjects
  • Look up Nationalrat roll calls, page individual member decisions and read complete vote and parliamentary-group counts
  • Find debate passages in the Amtliches Bulletin by business, subject, speaker, session, council or dates
  • Search current and former members and read their council terms, committee memberships and declared interests
  • Resolve reference codes, coverage, languages, committees, parties and sessions
When to use it
Useful when you need to research Swiss federal legislation, voting behaviour or parliamentary debates and want the assistant to pull the underlying records with source attribution instead of relying on general knowledge.
Requirements
No API key or account: the server uses the public OData service. Connect to the hosted endpoint, or run locally with npx (Node.js) or Docker. Optional settings cover transport, HTTP port, auth mode, log level and storage; none are required.
Before you install
Read-only, but results are an unofficial reproduction of Parliament data and the Parliament's open-data conditions apply to source content. Coverage is partial: roll calls only cover the Nationalrat from the 2003 winter session and transcripts from the 1999 winter session, so an empty result does not prove no vote or debate occurred. Missing values stay unknown, and empty interest lists do not establish absence of conflicts.

Installation

In SourceWeft

  1. Open Switzerland Parliament Mcp Server 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/io.github.cyanheads%2Fswitzerland-parliament-mcp-server/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": {
    "switzerland-parliament": {
      "type": "http",
      "url": "https://switzerland-parliament.caseyjhand.com/mcp"
    }
  }
}

README

@cyanheads/switzerland-parliament-mcp-server

Search Swiss parliamentary business, votes, debates, members, and declared interests via MCP. STDIO or Streamable HTTP.

7 Tools • 0 Resources • 0 Prompts

Overview

Swiss Federal Assembly records from Curia Vista and the Amtliches Bulletin. Find parliamentary business, read its original texts and procedural history, follow the debate in either council, inspect Nationalrat roll calls, and look up members and declared interests. Uses the public OData service without an API key; runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.

Results credit Parlamentsdienste der Bundesversammlung, Bern, with source URLs and download dates. This is an unofficial reproduction. The Parliament's open-data conditions apply to source content; underlying author rights remain intact.

Tools

ToolDescription
chparl_search_businessFind business by title, submitter, type, status, submission session, dates, or committee role
chparl_get_businessRead business metadata, original texts, status history, bills, related business, committee consultations, or debate subjects
chparl_get_votesFind Nationalrat roll calls, page member decisions, or read complete vote and parliamentary-group counts
chparl_search_transcriptsFind debate passages by business, subject, speaker, session, council, or dates; retrieve original text
chparl_search_membersFind current or former parliamentary affiliation records by name, council, canton, party, or group
chparl_get_memberRead parliamentary identity, council terms, committee memberships, or declared interests
chparl_list_referenceResolve identifiers, coverage, languages, codes, committees, and sessions

Capability reference

chparl_search_business tool

  • query (title substring), author (published submitter label, not every co-signatory), typeId, statusId, sessionId (submission session), committeeId, and inclusive submittedFrom / submittedTo. Newest business IDs first, default 20/max 100
  • Continue with nextCursor and unchanged filters; a cursor from other filters fails as invalid_cursor. totalCount is reported only without author or committee filters. Author searches use an extra matching row to establish continuation; committee searches page role candidates, so pages can be short

chparl_get_business tool

  • Canonical eight-digit businessId or an exact published short number such as 99.1234. A short number matching several businesses fails as ambiguous_business_number, and a miss returns found: false
  • overview (default) returns metadata and availableTextFields with UTF-8 sizes. texts returns textDocument.kind: "full" | "outline": several large fields become an outline, and named textFields always return whole
  • status_history, bills, related_business, preconsultations, and subjects page independently, default 20/max 100 with nextOffset. subjects IDs narrow chparl_search_transcripts; linked bills are parliamentary records, not enacted law

chparl_get_votes tool

  • mode: "votes" with businessId, sessionId, or both lists roll calls (default 10/max 50). A returned voteId feeds mode: "members" (default 50/max 100, optional personNumber) or mode: "groups" (unpaged). Paged modes continue with nextOffset
  • mode: "members" with personNumber and no voteId pages that member's voting history, optionally narrowed by businessId and sessionId. Each history row carries its published vote, business, session, and time fields; selected-vote pages carry that context once in vote. cantonId uses the canton reference's numbering; votingCantonId preserves the source Voting identifier
  • members counts carry decisionCounts.scope: "page". groups reads every published member row and returns scope: "vote", complete: true, and per-group totals by the affiliation recorded on the vote. Count buckets retain every distinct published label in decisionTexts. Decision codes: 1 yes, 2 no, 3 abstention, 4 present, 5 did not participate, 6 excused under Art. 57 para. 4, 7 president does not vote, 8 resigned
  • Nationalrat only, from the 2003 winter session. An empty result does not establish that no vote occurred

chparl_search_transcripts tool

  • Both councils from the 1999 winter session. Scope with businessId or subjectId (exclusive), personNumber, sessionId, or a date bound; council only narrows. query (original-text substring) also needs sessionId or a closed range of at most 31 calendar days
  • Metadata with textSizeBytes by default (20/max 100); includeText: true returns whole passages (3/max 10); an exact transcriptId defaults to full text. Continue with nextOffset
  • A business search covers up to 20 debate subjects; more fails as business_scope_too_broad, so page chparl_get_business section subjects and pass one subjectId. found marks exact-ID misses, scopeFound a missing business

chparl_search_members tool

  • query (first, last, or official name substring), membership (current default, former, all), council (N/S or the German, French, or Italian council name), cantonId, partyId, groupId. Default 20/max 100, nextOffset
  • Rows are MemberCouncil affiliation records, not deduplicated people. Their personNumber, which need not equal Person.ID, feeds chparl_get_member, chparl_get_votes, and chparl_search_transcripts

chparl_get_member tool

  • Requires personNumber. overview (default) returns identity and every MemberCouncil affiliation, unpaged; a miss returns found: false
  • council_terms, committees, and interests page independently, default 20/max 100 with nextOffset. Committee rows are published memberships, not a historical ledger. A missing paid flag means unknown, and empty interests do not establish the absence of conflicts

chparl_list_reference tool

  • Static topics identifiers, coverage, languages, and statuses (the official vocabulary effective 1 July 2023, each code tagged era: "legacy" | "current"). Live dictionaries business_types, councils, cantons, parties, groups, committees, and sessions
  • Default 50/max 100, nextOffset. Only sessions accepts dates: dateFrom bounds the start and dateTo the end, inclusively

Features

Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.

Swiss Parliament-specific:

  • Keyless, read-only access to business, procedural relationships, Nationalrat roll calls, debate passages, members, and declared interests
  • de (default), fr, and it metadata with no translation fallback; Italian completeness is not established. Bulletin text stays in the language the speaker used
  • Published text and HTML are returned unchanged, with an index of their links and images carrying absolute HTTP(S) URLs where the source supplies one
  • One 45-second deadline per complete workflow, covering joins and retries

Agent-friendly output:

  • Provenance on every result: attribution to Parlamentsdienste der Bundesversammlung, plus the source URL and retrieval time of each upstream response
  • Whole-record pages: replies fit a 24,000-byte budget by returning fewer records, never shorter fields, and report returnedCount, hasMore, totalCount when known, and the continuation
  • One record on both surfaces: content[] carries every structuredContent field, with multiline text and HTML in JSON-encoded fenced blocks that decode back losslessly
  • Unknown stays unknown: absent source values are omitted rather than defaulted, empty results carry next-step guidance, and failures carry typed reasons such as upstream_rate_limited

Getting started

Connect to the hosted instance, no install:

sh
claude mcp add --transport http switzerland-parliament-mcp-server https://switzerland-parliament.caseyjhand.com/mcp

Or run it locally:

sh
claude mcp add switzerland-parliament-mcp-server -- npx -y @cyanheads/switzerland-parliament-mcp-server

For other clients, add this to the MCP config file:

json
{  "mcpServers": {    "switzerland-parliament-mcp-server": {      "command": "npx",      "args": ["-y", "@cyanheads/switzerland-parliament-mcp-server"]    }  }}

For Docker or a source build, see Running the server.

Configuration

No server-specific environment variables are required.

VariableDescriptionDefault
MCP_TRANSPORT_TYPETransport: stdio or http.stdio
MCP_HTTP_PORTHTTP server port.3010
MCP_SESSION_MODEHTTP session mode: stateless, stateful, or auto.stateless
MCP_AUTH_MODEAuthentication: none, jwt, or oauth.none
MCP_LOG_LEVELLog level (debug, info, warning, error, etc.).info
LOGS_DIRDirectory for log files (Node.js only).<app-root>/logs
STORAGE_PROVIDER_TYPEStorage backend: in-memory, filesystem, supabase, cloudflare-kv/r2/d1.in-memory
OTEL_ENABLEDEnable OpenTelemetry.false

See .env.example for the common framework overrides.

Running the server

Local development

Requires Bun v1.4.0 or higher (or Node.js v24+).

sh
git clone https://github.com/cyanheads/switzerland-parliament-mcp-server.gitcd switzerland-parliament-mcp-serverbun installcp .env.example .env

  • Build and run the production version:

    sh
    # One-time buildbun run rebuild
# Run the built serverbun run start:http# orbun run start:stdio

  • Run checks and tests:

    sh
    bun run devcheck  # Lints, formats, type-checks, and morebun run test      # Runs the test suite

Docker

sh
docker run --rm -p 3010:3010 ghcr.io/cyanheads/switzerland-parliament-mcp-server:latest

The image defaults to HTTP transport, stateless sessions, and logs to /var/log/switzerland-parliament-mcp-server. For stdio, use "command": "docker" with "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "ghcr.io/cyanheads/switzerland-parliament-mcp-server:latest"]. Build locally with docker build -t switzerland-parliament-mcp-server .; --build-arg OTEL_ENABLED=false omits OpenTelemetry peers.

Project structure

DirectoryPurpose
src/index.tscreateApp() entry point and service setup; seven tools, no resources or prompts.
src/mcp-server/toolsTool definitions, shared lossless rendering, and whole-record page fitting.
src/services/parliamentOData client, workflow deadlines, domain schemas and services, provenance, and reference snapshots.
tests/Unit and integration tests, mirroring the src/ structure.

Development guide

See CLAUDE.md for development guidelines and architectural rules. The short version:

  • Handlers throw, framework catches — no try/catch in tool logic
  • Use ctx.log for logging, ctx.state for storage
  • Register new tools and resources in the createApp() arrays in src/index.ts
  • Wrap external API calls: validate raw → normalize to domain type → return output schema; never fabricate missing fields

Contributing

Issues are welcome. Run checks and tests before submitting:

sh
bun run devcheckbun run test

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.

Source: README.md at commit 72ea577

Tools

7

chparl_search_business

Chparl Search Business

Search Swiss parliamentary business by title substring, published submitter label, type, current status, submission session, inclusive submission dates, or committee role. Use chparl_list_reference to resolve codes and chparl_get_business to read a returned businessId. Follow nextCursor with unchanged filters; newest canonical business IDs appear first. Author searches omit the business total. Committee searches page role candidates and may return short pages without a distinct business total. Metadata labels remain in de, fr, or it without translation fallback.

ParameterslimitqueryauthorcursortypeIdlanguagestatusIdsessionIdcommitteeIdsubmittedTosubmittedFrom

chparl_get_business

Chparl Get Business

Read a Swiss parliamentary business by canonical eight-digit businessId or exact published short number. Choose overview for metadata and available text sizes; texts for original published text, automatically outlined when several fields exceed the disclosure budget; or status_history, bills, related_business, preconsultations, or subjects for independently paged relationships. textFields selects complete original fields only in texts, even when large. Paging applies only to relationships. Use subjects to narrow chparl_search_transcripts; source text and HTML remain unchanged.

ParameterslimitoffsetsectionlanguagebusinessIdrequiredtextFields

chparl_get_votes

Chparl Get Votes

Find Nationalrat roll calls with mode votes and businessId, sessionId, or both. Use mode members with voteId for one paged roll call, or personNumber without voteId for member history optionally filtered by businessId and sessionId. Use mode groups with voteId for complete decision counts by parliamentary group. Member roll calls start in the 2003 winter session and exclude Ständerat member votes; an empty result does not prove no vote occurred. Member counts cover only delivered rows; groups mode reads all published member rows before reporting totals. Verbatim decisionTexts accompany code buckets when published. Code meanings include 1 yes, 2 no, 3 abstention, 4 present, 5 did not participate, 6 excused under Art. 57 para. 4, 7 president does not vote, and 8 resigned. Unknown codes and missing decisions are retained. Follow nextOffset with the same mode and filters.

ParametersmodelimitoffsetvoteIdlanguagesessionIdbusinessIdpersonNumber

chparl_search_transcripts

Chparl Search Transcripts

Find Amtliches Bulletin passages by business, debate subject, speaker, session, council, or inclusive meeting dates. Supply at least a business, subject, speaker, session, or date bound. A text substring query additionally requires sessionId or a closed date range of at most 31 calendar days. Searches return metadata by default; includeText returns whole original passages, and an exact transcriptId defaults to full text. Metadata language never translates the speaker text; missing LanguageOfText remains unknown. Business searches cover every associated subject up to 20; larger debates require selecting subjectId through chparl_get_business section subjects. Follow nextOffset with unchanged filters.

ParameterslimitquerydateTooffsetcouncildateFromlanguagesessionIdsubjectIdbusinessIdincludeTextpersonNumber+1 more

chparl_search_members

Chparl Search Members

Find current or former Swiss Parliament affiliation records by name, council, canton, party, or parliamentary group. membership defaults to current; former selects inactive records and all omits the activity filter. query matches a substring of a published first, last, or official name. Use each record’s personNumber with chparl_get_member for identity, full council terms, committees, and declared interests. Follow nextOffset with the same filters.

ParameterslimitqueryoffsetcouncilgroupIdpartyIdcantonIdlanguagemembership

chparl_get_member

Chparl Get Member

Read a Swiss Parliament member by PersonNumber, which need not equal Person.ID. overview returns identity and every base MemberCouncil affiliation without pagination. Select council_terms for historical council terms, committees for published MemberCommittee rows, or interests for declared interests; those sections accept limit and offset. Missing paid status means unknown, and empty interests do not establish absence of conflicts of interest. Metadata labels remain in the selected language.

ParameterslimitoffsetsectionlanguagepersonNumberrequired

chparl_list_reference

Chparl List Reference

List Swiss Parliament reference entries and source coverage. Choose identifiers, coverage, or languages for server explanations; statuses for the official legacy/current status snapshot; or business_types, councils, cantons, parties, groups, committees, or sessions for live dictionaries. Date filters apply only to sessions. Follow nextOffset with the same topic, language, and dates; labels remain in the requested metadata language and missing labels stay unknown.

ParameterslimittopicrequireddateTooffsetdateFromlanguage

Version history

2
  1. v0.1.2LatestOct 26, 2026
  2. v0.1.1Oct 25, 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