sns-portugal-mcp

[!WARNING] Deprecated — use portugal-mcp instead. This server now lives on as the saude feature of portugal-mcp, together with IPMA weather, INE, Banco de Portugal, Parliament, public contracts and more. Install with uvx portugal-mcp (add PORTUGAL_MCP_FEATURES=saude to load only this part). Tool names: find_institutions → sns_find_institutions, emergency_stats → sns_emergency_stats, surgery_wait_stats → sns_surgery_wait_stats, consultation_wait_stats → sns_consultation_wait_stats, search_datasets → sns_search_datasets, query_dataset → sns_query_dataset. This repository gets no further updates.

MCP server for official open-data statistics about Portugal's national health service (SNS), so Claude (or any MCP client) can answer "how busy is the emergency department at Santa Maria?", "how many people are waiting for surgery in the Norte region?" or "which SNS hospitals are near me?".

Read-only, no key, no account. It uses only public open data. Not affiliated with the SNS, SPMS or the Portuguese Ministry of Health.

Statistics, not the live queue. The figures are official monthly statistics; the newest month is usually 2-3 months old and provisional. This server does not show live emergency-room waiting times. For those, see tempos.min-saude.pt.

Not medical advice. In an emergency call 112. For health advice call SNS 24 on 808 24 24 24.

Tools

find_institutions

Finds SNS hospitals and local health units (ULS) by name, or the nearest ones to a coordinate. Each result says whether the place reports emergency, consultation and surgery data, and gives stats_entity: the name the statistics use for it. Statistics are published per ULS or hospital group, not per building.

Parameters: query (name, accent-insensitive), lat / lon (sort by distance), emergency_only, limit.

emergency_stats

Emergency-department visits per month, by type (general, paediatric, obstetric, psychiatric) and by Manchester triage colour (red, orange, yellow, green, blue, white, not triaged), with each colour's share of the month. Covers one institution, one region, or the whole country.

Parameters: institution, region (Norte | Centro | LVT | Alentejo | Algarve), period ("YYYY-MM", latest month to include), months (default 6).

surgery_wait_stats

Surgery access per month:

• the surgical waiting list (LIC) at month end;
• the % of waiting patients still within the legal maximum guaranteed time (TMRG);
• the mean days from hospital admission to the operation (scheduled inpatient surgery);
• surgeries performed: scheduled (inpatient and day surgery) and urgent.

Same parameters as emergency_stats. The open data has no breakdown by specialty.

consultation_wait_stats

Hospital outpatient consultations per month (first and follow-up), plus the % of first specialist consultations (referred by a family doctor) held within the TMRG. Same parameters as above.

search_datasets

Searches the 149 datasets of the SNS Transparency portal by keyword. Titles are in Portuguese, so Portuguese keywords work best: "ocupação", "partos", "rastreios", "SNS 24", "INEM". Returns each dataset's id, description and field names.

query_dataset

Runs an ODSQL query (where, select, group_by, order_by, limit, offset) on any portal dataset. Use it for anything the tools above don't cover.

Year-to-date values

Most hospital-activity datasets publish year-to-date cumulative values, so the December figure is the annual total. The curated tools return both the year-to-date value and a derived in_month value (this month minus the previous one). If you use query_dataset directly, do that subtraction yourself.

Install

Quickest (needs [uv](https://d

... View full README on GitHub