# SNS Portugal (pypi · sns-portugal-mcp)

Portugal's national health service open data: hospitals, emergency and waiting times.

- Trust score: 78/100 (medium)
- Registry status: deprecated
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

> **Deprecated**: this server is marked deprecated in the MCP registry. The registry records this reason: "Deprecated: now part of portugal-mcp (io.github.ThiagoJacobLannes/portugal-mcp)."

## Components

- pypi · `sns-portugal-mcp`: 78/100 (this document), [markdown](https://verifymcp.io/servers/thiagojacoblannes-sns-portugal-mcp/sns-portugal-mcp.md), [page](https://verifymcp.io/servers/thiagojacoblannes-sns-portugal-mcp/sns-portugal-mcp)

## Channel facts

- Registry: `pypi`
- Package: `sns-portugal-mcp`
- Version: `0.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it.
  - 0 of 28 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to ThiagoJacobLannes/sns-portugal-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 2 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 58/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1964 tokens (~327/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 17/100
  - Stability observed for 5 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 71/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 6 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 7 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the SNS Portugal MCP server?

SNS Portugal runs locally as a PyPI package, launched with uvx sns-portugal-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add thiagojacoblannes-sns-portugal-mcp -- uvx sns-portugal-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "thiagojacoblannes-sns-portugal-mcp": {
      "command": "uvx",
      "args": [
        "sns-portugal-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "thiagojacoblannes-sns-portugal-mcp": {
      "command": "uvx",
      "args": [
        "sns-portugal-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add thiagojacoblannes-sns-portugal-mcp -- uvx sns-portugal-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "thiagojacoblannes-sns-portugal-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "sns-portugal-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add thiagojacoblannes-sns-portugal-mcp --command uvx --arg sns-portugal-mcp
```

### Hermes

```yaml
mcp_servers:
  thiagojacoblannes-sns-portugal-mcp:
    command: "uvx"
    args: ["sns-portugal-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "thiagojacoblannes-sns-portugal-mcp": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "sns-portugal-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add thiagojacoblannes-sns-portugal-mcp -t stdio -c uvx -a sns-portugal-mcp
```

### Other

```json
{
  "mcpServers": {
    "thiagojacoblannes-sns-portugal-mcp": {
      "command": "uvx",
      "args": [
        "sns-portugal-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 78, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-02 (score 77, +16)

- [security improvement] Malware scan: unverified → pass
- [functional improvement] Stability: unverified → 0.07
- [functional] Package version: 0.1.0 → 0.1.1

### 2026-10-31 (score 61)

First indexed and scored.

## MCP tools (6)

### `find_institutions` (~324 tokens)

Find SNS hospitals / local health units (ULS) by name, or the nearest ones to a coordinate.

Use this first when the user names a hospital or a place ("hospitals near Lisbon",
"is there an emergency department near 38.72,-9.14?"), then pass `stats_entity` to
emergency_stats / surgery_wait_stats / consultation_wait_stats.

Each result: name, its parent ULS, coordinates, distance_km (when lat/lon given), whether
it reports emergency / consultation / surgery data on tempos.min-saude.pt, and
\`stats_entity` — the name under which the official statistics report it (statistics are
per ULS / hospital group, not per building). This list does NOT contain live waiting times;
for live emergency waits send the user to https://tempos.min-saude.pt.

Args:
    query:          Part of the name, accent-insensitive, e.g. "Santa Maria", "Faro", "ULS Algarve".
    lat, lon:       Sort by distance from this point (WGS84), e.g. Lisbon 38.7223, -9.1393.
                    Without `query`, umbrella ULS entries are skipped (they duplicate a hospital's location).
    emergency_only: Only places that report emergency-department data.
    limit:          Max results (default 10, max 50).

Input parameters:

- `emergency_only` (boolean)
- `lat`
- `limit` (integer)
- `lon`
- `query`

### `emergency_stats` (~365 tokens)

Emergency-department (urgência) visits per month: by type and by Manchester triage colour.

Use for "how busy is the ER at X?", "how many emergency visits in the Algarve last month?",
"what share of ER visits are green/blue (non-urgent)?". OFFICIAL MONTHLY STATISTICS ONLY —
not the live queue (the latest month is usually 2-3 months back and provisional). For live
waiting times send the user to https://tempos.min-saude.pt. Not medical advice: in an
emergency call 112; SNS 24 (808 24 24 24) for advice.

Scope: one institution, one region, or (neither) all of mainland Portugal's SNS hospitals.

Per period (latest first): visits_in_month and visits_year_to_date by type (general,
paediatric, obstetric, psychiatric, total), triage_in_month by colour (red = immediate,
orange = very urgent, yellow = urgent, green = less urgent, blue = non-urgent, white = not
clinical / other) and triage_share_in_month_pct.

Args:
    institution: Hospital or ULS name, accent-insensitive ("Santa Maria", "São João",
                 "Hospital de Faro"). A hospital is mapped to its ULS; check `scope`.
    region:      Norte | Centro | LVT (Lisboa) | Alentejo | Algarve. Ignored if institution is given.
    period:      Latest month to include, "YYYY-MM" (default: newest available).
    months:      How many months back to return (default 6, max 24).

Input parameters:

- `institution`
- `months` (integer)
- `period`
- `region`

### `surgery_wait_stats` (~350 tokens)

Surgery access indicators per month: surgical waiting list, % within the guaranteed
maximum time, mean days from admission to surgery, and surgeries performed.

Use for "how long is the wait for surgery at X?", "how many people are on the surgery list
in the Norte region?", "how many operations did hospital Y do?". Official monthly statistics
(latest month usually 2-3 months back, provisional). The open data has NO breakdown by
specialty or procedure — say so if asked for one.

Per period (latest first):
  \- waiting_list: patients on the surgical waiting list (LIC) at month end, how many are
    still within the legal maximum guaranteed response time (TMRG, 180 days for normal
    priority since 2018) and the % within it.
  \- mean_days_before_surgery_in_month / _year_to_date: average days between hospital
    admission and the operation for scheduled inpatient surgery (this is NOT the time on
    the waiting list).
  \- surgeries_in_month / surgeries_year_to_date: scheduled (= inpatient + day surgery) and urgent.

Args:
    institution: Hospital or ULS name ("Santa Maria", "Coimbra", "IPO Porto"); mapped to its ULS.
    region:      Norte | Centro | LVT (Lisboa) | Alentejo | Algarve. Ignored if institution is given.
    period:      Latest month to include, "YYYY-MM" (default: newest available).
    months:      How many months back (default 6, max 24).

Input parameters:

- `institution`
- `months` (integer)
- `period`
- `region`

### `consultation_wait_stats` (~256 tokens)

Hospital outpatient consultations per month and the % of FIRST specialist consultations
(referred by a family doctor via CTH/SIGA) held within the guaranteed maximum time (TMRG).

Use for "how long is the wait for a first hospital appointment at X?", "is hospital Y on
time with first consultations?", "how many consultations did the Centro region do?".
Official monthly statistics (latest month usually 2-3 months back, provisional); there is no
breakdown by specialty in the open data.

Per period (latest first): consultations_in_month / _year_to_date (total, first,
subsequent) and first_consultations_within_max_time_pct for the month and year-to-date.

Args:
    institution: Hospital or ULS name; mapped to its ULS.
    region:      Norte | Centro | LVT (Lisboa) | Alentejo | Algarve. Ignored if institution is given.
    period:      Latest month to include, "YYYY-MM" (default: newest available).
    months:      How many months back (default 6, max 24).

Input parameters:

- `institution`
- `months` (integer)
- `period`
- `region`

### `search_datasets` (~195 tokens)

Search the ~150 datasets of the SNS Transparency portal (titles and descriptions are in Portuguese).

Use when the curated tools don't cover the question — e.g. hospital bed occupancy
("ocupação"), births/caesareans ("partos"), INEM pre-hospital calls, SNS 24 calls, family
doctor coverage ("médico de família", "inscritos"), medicines spending, staff ("trabalhadores"),
cancer screening ("rastreios"). Then call query_dataset with the dataset_id and the field names
returned here. Portuguese keywords work best; matching is accent-insensitive.

Args:
    query: Keywords, e.g. "ocupação internamento", "partos", "urgência". Empty = list all (id + title).
    limit: Max results (default 10, max 50; ignored when listing all).

Input parameters:

- `limit` (integer)
- `query`

### `query_dataset` (~343 tokens)

Run an ODSQL query on any SNS Transparency portal dataset (Opendatasoft Explore API v2.1).

Use after search_datasets for anything the curated tools don't cover. Clauses are ODSQL:
  \- where:    `instituicao like "santa maria" and tempo >= date'2026-01-01'`
              (`like` is a case- and accent-insensitive "contains"; dates use date'YYYY-MM-DD')
  \- select:   `tempo, instituicao, total_urgencias` or aggregates `sum(total_urgencias) as total`
  \- group_by: `regiao` or `tempo`  (combine with aggregates in select)
  \- order_by: `tempo desc`
Most hospital-activity datasets (field `tempo`, monthly) store YEAR-TO-DATE CUMULATIVE
values: December is the annual total; a single month = this month minus the previous one.
Many datasets have a `regiao` and an `instituicao` (or `entidade`) field. Official statistics,
not live data.

Args:
    dataset_id: e.g. "ocupacao-do-internamento" (from search_datasets).
    where, select, group_by, order_by: ODSQL clauses (optional).
    limit:  Rows to return (default 20, max 100).
    offset: Skip rows, for paging.

Input parameters:

- `dataset_id` (string, required)
- `group_by`
- `limit` (integer)
- `offset` (integer)
- `order_by`
- `select`
- `where`

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/thiagojacoblannes-sns-portugal-mcp/sns-portugal-mcp#diagnostics

## Score history

- 2026-11-05: 78
- 2026-11-04: 77
- 2026-11-03: 77
- 2026-11-02: 77
- 2026-11-01: 61
- 2026-10-31: 61

## Common questions

### What is the SNS Portugal MCP server?

SNS Portugal is an MCP server listed in the public MCP registry as io.github.ThiagoJacobLannes/sns-portugal-mcp. Portugal's national health service open data: hospitals, emergency and waiting times. This page covers its PyPI package (sns-portugal-mcp).

### Is the SNS Portugal MCP server safe to use?

SNS Portugal scores 78 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the SNS Portugal MCP server expose?

SNS Portugal exposes 6 tools: find_institutions, emergency_stats, surgery_wait_stats, consultation_wait_stats, search_datasets, query_dataset. Their descriptions and schemas cost roughly 1,833 tokens of context every time the server is loaded.

### Is the SNS Portugal MCP server still maintained?

SNS Portugal is marked deprecated in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the SNS Portugal MCP server under?

SNS Portugal declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the SNS Portugal MCP server?

VerifyMCP ran 16 checks on SNS Portugal, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- PyPI project: https://pypi.org/project/sns-portugal-mcp/
- Socket report: https://socket.dev/pypi/package/sns-portugal-mcp
- Repository: https://github.com/ThiagoJacobLannes/sns-portugal-mcp
- Website: https://thiagolannes.com/
- Changelog RSS feed: https://verifymcp.io/servers/thiagojacoblannes-sns-portugal-mcp/sns-portugal-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/thiagojacoblannes-sns-portugal-mcp/sns-portugal-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/thiagojacoblannes-sns-portugal-mcp/sns-portugal-mcp.json
- HTML version of this page: https://verifymcp.io/servers/thiagojacoblannes-sns-portugal-mcp/sns-portugal-mcp