io.github.malkreide/bag-health-mcp

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><example>bag_health_mcp__download_export(file='INFLUENZA_oblig', format='csv') -> raw CSV content.</example>

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><example>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?'</example>

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><example>bag_health_mcp__get_data_version() -> version='20260325', date='2026-03-25'.</example>

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><example>bag_health_mcp__get_disease_data(series_id='influenza/cases/incValue/iso_week', canton='ZH') -> weekly influenza incidence for Zurich.</example>

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><example>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.</example>

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><example>bag_health_mcp__get_series_details(series_id='influenza/cases/incValue/iso_week') -> cantons=['ZH','BE',...], age_groups=[...].</example>

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><example>bag_health_mcp__list_diseases() -> categories incl. 'influenza', 'measles', 'covid19'.</example>

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><example>bag_health_mcp__list_export_files() -> ['INFLUENZA_oblig', 'COVID19_wastewater_sequencing', ...].</example>

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><example>bag_health_mcp__list_series(topic='influenza') -> 'influenza/cases/incValue/iso_week', ...</example>

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><example>bag_health_mcp__search_health_indicators(source='suchtschweiz', topic='alkohol') -> Obsan HBSC alcohol-prevalence indicators.</example>