bag-health-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_HOST | No | Host to bind the server to. Default is 127.0.0.1. | |
| MCP_PORT | No | Port to listen on. Default is 8000. | |
| MCP_LOG_LEVEL | No | Log level (default INFO). | |
| MCP_TRANSPORT | No | Transport protocol (http or stdio). Default is stdio. | |
| MCP_AUTH_TOKEN | No | Optional token for HTTP Bearer authentication. | |
| MCP_CORS_ORIGINS | No | Comma-separated list of allowed CORS origins for browser clients. | |
| OTEL_SERVICE_NAME | No | Service name for OpenTelemetry tracing. | |
| OTEL_EXPORTER_OTLP_ENDPOINT | No | OpenTelemetry OTLP endpoint for tracing. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| bag_health_mcp__list_diseasesA | List all 51 disease topics available in the BAG Infectious Disease Dashboard (IDD). Returns the topic slug needed for other tools, grouped by category (respiratory, enteric, STI, vector-borne, wastewater). <use_case>Discover what diseases are available before querying data.</use_case><important_notes>Start here; the topic slugs returned are required inputs for the other tools.</important_notes>bag_health_mcp__list_diseases() -> categories incl. 'influenza', 'measles', 'covid19'. |
| bag_health_mcp__list_seriesA | List all available data series for a specific disease topic. Each series is identified by 'topic/chapter/aggregation/temporality'. Returns series IDs to use with bag_health_mcp__get_series_details and bag_health_mcp__get_disease_data.<use_case>Find which exact series exist for a disease (e.g. weekly cases vs yearly incidence) before fetching data.</use_case><important_notes>Needs a valid topic slug from bag_health_mcp__list_diseases.</important_notes>bag_health_mcp__list_series(topic='influenza') -> 'influenza/cases/incValue/iso_week', ... |
| bag_health_mcp__get_series_detailsA | Get metadata and available filter values for a specific data series. Shows which canton, age group, sex, and other dimensions are available. Always call this before bag_health_mcp__get_disease_data to know valid filter options.<use_case>Learn the valid filter values (cantons, age groups, sex) for a series so a subsequent data query uses accepted parameters.</use_case><important_notes>Available dimensions vary by series — always check here rather than assuming.</important_notes>bag_health_mcp__get_series_details(series_id='influenza/cases/incValue/iso_week') -> cantons=['ZH','BE',...], age_groups=[...]. |
| bag_health_mcp__get_disease_dataA | Fetch time-series surveillance data for a disease from the BAG IDD. Returns weekly or yearly case counts, incidence rates, or other metrics. Data updated every Wednesday. <use_case>Get the actual numbers/trend for a disease in a canton over time — the core data-retrieval tool.</use_case><important_notes>Call bag_health_mcp__get_series_details first for valid filters. 'incValue' = incidence per 100'000; 'value' = absolute count.</important_notes>bag_health_mcp__get_disease_data(series_id='influenza/cases/incValue/iso_week', canton='ZH') -> weekly influenza incidence for Zurich. |
| bag_health_mcp__list_export_filesA | List all available export file names from the BAG IDD. These are complete datasets (CSV/JSON) per disease, e.g. INFLUENZA_oblig, COVID19_wastewater_sequencing, MEASLES_oblig. Use with bag_health_mcp__download_export to get raw data files.<use_case>Discover which complete bulk datasets can be downloaded for offline/bulk analysis.</use_case><important_notes>Returns file names, not the data — pass one to bag_health_mcp__download_export.</important_notes>bag_health_mcp__list_export_files() -> ['INFLUENZA_oblig', 'COVID19_wastewater_sequencing', ...]. |
| bag_health_mcp__download_exportA | Download a complete export dataset from the BAG IDD as CSV or JSON. Returns the raw data content for a specific disease file. Useful for bulk analysis. Files are updated weekly.<use_case>Retrieve a full raw dataset (all rows) for one disease for downstream/offline analysis.</use_case><important_notes>The preview is truncated at 3000 chars; for very large datasets use the IDD web interface. Get file names from bag_health_mcp__list_export_files.</important_notes>bag_health_mcp__download_export(file='INFLUENZA_oblig', format='csv') -> raw CSV content. |
| bag_health_mcp__get_data_versionA | Get the current data version of the BAG IDD. Returns the date of the last data update (format YYYYMMDD). IDD is updated every Wednesday.<use_case>Check how fresh the data is / which weekly snapshot you are looking at.</use_case><important_notes>Data is updated only weekly (Wednesdays); not real-time.</important_notes>bag_health_mcp__get_data_version() -> version='20260325', date='2026-03-25'. |
| bag_health_mcp__get_canton_situationA | Get a public health situation overview for a specific canton or Switzerland. Combines current incidence data for key school-relevant diseases (influenza, measles, norovirus proxy via acute_respiratory_infection) with trend information. Designed for school authorities and city administration Public Health Reporting. <use_case>One-call situational overview for a canton (Schulamt / city administration) without orchestrating multiple series queries.</use_case><important_notes>Aggregates several series; a single unavailable series is reported as a per-disease status, not a failure of the whole call.</important_notes>bag_health_mcp__get_canton_situation(canton='ZH') -> per-disease latest value, trend and change for Zurich. Anchor query: 'Wie ist die aktuelle Grippesituation im Kanton Zürich?' |
| bag_health_mcp__search_health_indicatorsA | Search health indicators across three Swiss sources: 'obsan' (Swiss Health Observatory — hundreds of indicators incl. the HBSC youth-survey series), 'versorgungsatlas' (Swiss health-care supply atlas, ~124 indicators), and 'suchtschweiz' (addiction / HBSC series, served via Obsan's official mirror). Returns matching indicator_ids to pass to bag_health_mcp__get_indicator_series. IMPORTANT: this serves AGGREGATED population statistics (prevalences/metrics by age/sex/region) — NOT individual advice, diagnosis or case assessment, and no personal data. Especially for 'suchtschweiz' (prevention topics in a school context): the figures are population-level survey aggregates only. <use_case>Find which indicators exist for a topic (e.g. youth alcohol) before fetching a series.</use_case><important_notes>The catalogue does not state which cuts an indicator publishes — get_indicator_series reports that per indicator ('variant', 'variants_available'). Most Obsan indicators DO have a cantonal cut (50 of 60 sampled); the HBSC youth series (source='suchtschweiz', ages 11-15) is the exception and is national only, as HBSC is not cantonally representative. Other 'monam' indicators come from the Swiss Health Survey and are cantonal. A few catalogue entries have no series at all; the series call names that case rather than returning nothing.</important_notes>bag_health_mcp__search_health_indicators(source='suchtschweiz', topic='alkohol') -> Obsan HBSC alcohol-prevalence indicators. |
| bag_health_mcp__get_indicator_seriesA | Fetch one health indicator's time series from Obsan, the Versorgungsatlas or Sucht Schweiz (HBSC). Use an indicator_id from bag_health_mcp__search_health_indicators. Obsan publishes an indicator in several CUTS (national, by canton, by age class, by social position, as a distribution); this tool picks one, names it in 'variant' and lists the others in 'variants_available'. They are different measurements with different units, not interchangeable. Pass region='ZH' for the cantonal cut where the indicator has one. Versorgungsatlas returns a cantonal year/value series (26 cantons + a 'CH' total, 95% CIs, canton-vs-Switzerland ratio). IMPORTANT: AGGREGATED population statistics only — NOT individual advice, diagnosis or case assessment, no personal data. For 'suchtschweiz' (school-context prevention topics) the values are national HBSC survey aggregates by age/sex. <use_case>Get a national trend, or a cantonal series with a Switzerland comparison.</use_case><important_notes>Read 'variant' before reading the numbers: 'g'/'kg' are rates, 'gum' is a distribution in %. The HBSC youth series (source='suchtschweiz', ages 11-15) is national only — a canton request returns the national cut with a note, because HBSC is not cantonally representative. Some Obsan observations are pooled spans ('1998-02' = 1998–2002); those carry the full label in 'period' and its first year in 'year'. Where an indicator publishes no series, the call fails with that reason instead of returning an empty series.</important_notes>bag_health_mcp__get_indicator_series(source='obsan', indicator_id='obsan/lebenserwartung', region='ZH') -> ZH life expectancy from the 'kg' cut, with the source's own canton and category legends. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| canton_situation_brief | Draft a structured public-health situation brief for a Swiss canton (Schulamt / city-administration use case). |
| outbreak_check | Check whether a given disease is currently elevated in Switzerland. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| swiss_cantons | The Swiss canton codes accepted by the tools (incl. FL and 'all'). |
| disease_categories | The disease-topic taxonomy: known IDD topic slugs grouped by category. Static reference; use bag_health_mcp__list_diseases for what the live API currently serves. |
| data_licence | Data source, attribution and licence terms for the BAG IDD data. |
TDQS
Scored across 10 tools
The tools are mostly distinct, but the term 'series' appears in list_series, get_series_details, and get_indicator_series, which could cause slight confusion. Descriptions clearly differentiate sources (BAG IDD vs Obsan/other indicators), so an attentive agent can tell them apart.
All tool names follow a consistent snake_case verb_noun pattern with the same prefix, e.g. list_diseases, get_disease_data, download_export. No deviations or mixed conventions.
10 tools is well within the ideal range for a data-access server; each tool serves a clear purpose in discovery, metadata, or retrieval, with no obvious redundancy.
The surface covers full workflows for both disease surveillance (list -> series -> details -> data) and indicators (search -> fetch), plus bulk export and versioning. A minor gap is the lack of a dedicated 'list all indicators' tool, but search likely covers this.