io.github.remoprinz/swiss-health-mcp

Official

by remoprinz · JavaScript

Swiss health insurance premiums (Krankenkassen-Prämien) 2016-2026. 1.6M records from BAG.

An MCP server that provides structured access to Swiss health insurance premium data (Krankenkassen-Prämien) from 2016–2026. It is based on the Model Context Protocol and serves official government data sourced from BAG Priminfo, covering 1.6M records across 55 insurers and 26 cantons.

🛠️ Key Features

Structured access to 1.6 million premium records
Coverage: 2016–2026 (11 years)
Dimensions: 55 insurers and 26 cantons
Official data source: BAG Priminfo

🚀 Use Cases

Querying or retrieving Swiss health insurance premiums by insurer and canton
Using government premium history across multiple years (2016–2026)

⚡ Developer Benefits

MCP-compatible interface for AI assistants
Dataset scope spans 11 years and large record volume (1.6M)

⚠️ Limitations

Described scope is Swiss health insurance premiums (Krankenkassen-Prämien) from BAG Priminfo (2016–2026); no other datasets are specified.

README.md6 KBView on GitHub

Swiss Health MCP Server

npm version

An MCP server that gives AI assistants structured access to 1.6 million Swiss health insurance premium records -- 55 insurers, 26 cantons, 11 years of official government data.

Built on the Model Context Protocol. Data sourced from BAG Priminfo (Swiss Federal Office of Public Health, 2016--2026). This is the MCP companion to the KrankenkassenGPT REST API.

Quick Start

Add this to your Claude Desktop config (claude_desktop_config.json) or Cursor settings (.cursor/mcp.json):

json

{
  "mcpServers": {
    "swiss-health": {
      "command": "npx",
      "args": ["-y", "@prinz_esox/swiss-health-mcp"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key"
      }
    }
  }
}

Or install globally:

bash

npm install -g @prinz_esox/swiss-health-mcp

The server is also available on the Smithery registry and the MCP Registry.

Tools

`get_cheapest_insurers`

Find the top 5 cheapest health insurers for a given profile.

Parameter	Type	Required	Description
`canton`	string	yes	Canton code (e.g. `ZH`, `BE`, `GE`)
`year`	number	yes	Year (2016--2026)
`age_band`	string	yes	`child` (0--18), `young_adult` (19--25), `adult` (26+)
`franchise_chf`	number	yes	Deductible: 0, 100, 200, 300, 400, 500, 600, 1000, 1500, 2000, 2500
`model_type`	string	no	`standard` (default), `hmo`, `telmed`, `family_doctor`, `diverse`
`accident_covered`	boolean	no	Include accident coverage (default: `true`)

`compare_insurers`

Side-by-side comparison of specific insurers for the same profile.

Parameter	Type	Required	Description
`insurer_names`	string[]	yes	Insurer names (e.g. `["CSS", "Helsana", "Swica"]`)
`canton`	string	yes	Canton code
`year`	number	yes	Year (2016--2026)
`age_band`	string	yes	Age group
`franchise_chf`	number	yes	Deductible in CHF

`get_price_history`

10-year price development for a single insurer with year-over-year percentage change.

Parameter	Type	Required	Description
`insurer_name`	string	yes	Insurer name (e.g. `CSS`, `Helsana`)
`canton`	string	yes	Canton code
`age_band`	string	yes	Age group
`franchise_chf`	number	yes	Deductible in CHF
`start_year`	number	no	Start year (default: 2016)
`end_year`	number	no	End year (default: 2026)

`get_database_stats`

Returns coverage statistics and metadata. No parameters.

Data

Dimension	Coverage
Records	1,611,386+
Insurers	55 (CSS, Helsana, Swica, Assura, KPT, Groupe Mutuel, Sanitas, ...)
Cantons	26 (all Swiss cantons)
Years	11 (2016--2026)
Franchise levels	11 (CHF 0--2,500)
Insurance models	5 (standard, HMO, telmed, family doctor, diverse)
Age bands	3 (child, young adult, adult)

All data comes from BAG Priminfo, the official database of the Swiss Federal Office of Public Health.

Features

Intelligent insurer name resolution -- fuzzy matching across 55+ insurers and their sub-brands. Ask for "Helsana" and the server resolves all associated insurer IDs automatically.
Automatic disclaimer -- every response includes BAG Priminfo attribution and a notice that premiums are informational only.
Read-only access -- no write operations, no personal data.
Percentage change calculations -- price history includes year-over-year trends.

Example Prompts

code

"What are the cheapest health insurers in Zurich for 2026?"

"Compare CSS, Helsana and Swica in Bern for an adult with CHF 300 deductible"

"How did Assura premiums develop from 2016 to 2026?"

"Which insurer had the smallest price increase over the last 10 years in Basel?"

Environment Variables

Variable	Required	Description
`SUPABASE_URL`	yes	Supabase project URL
`SUPABASE_SERVICE_ROLE_KEY`	yes	Supabase service role key for database access

Tech Stack

Protocol: MCP SDK v1.0.0 (stdio transport)
Language: TypeScript
Database: Supabase (PostgreSQL)
Runtime: Node.js 18+
Package: @prinz_esox/swiss-health-mcp
Registry ID: io.github.remoprinz/swiss-health-mcp

Development

bash

git clone https://github.com/remoprinz/swiss-health-mcp.git
cd swiss-health-mcp
npm install
npm run dev     # Start with tsx
npm run build   # Compile TypeScript

Project Structure

code

src/index.ts       # Complete server implementation (~530 lines)
server.json        # MCP registry manifest
smithery.yaml      # Smithery registry config
llms.txt           # LLM-readable project description
CITATION.cff       # Citation metadata

License

MIT -- Remo Prinz

Install

Configuration

Environment variables

SUPABASE_URLrequired

Supabase Project URL (e.g. https://xxx.supabase.co)

SUPABASE_SERVICE_ROLE_KEYrequiredsecret

Supabase Service Role Key for database access

Add to VS Code Add to Cursor

claude_desktop_config.json