# SNS Portugal Health Transparency AI Agent Connect

> Official Portuguese national health service (SNS) open data: SNS24 calls, consultations, surgeries, transplants, blood donors, clinical trials, medicines and the SNS budget — queryable with filters and pagination, zero-auth.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_MH3coBDiqA93acPmTqHpP6o5Ug58Udpq80J7UXMB/ai-agent-connect
- **Tags:** portugal, sns, healthcare-data, public-health, open-data, transparency

## Description

The **official transparency portal of Portugal's Serviço Nacional de Saúde** as a single MCP server — 144 datasets of authoritative Portuguese public-health data.

### What you can do
- **Browse the catalog** — SNS24 call volumes, primary-care nursing contacts, scheduled consultations, surgeries, transplants and donors, clinical trials, medicines stock and prescriptions, the SNS budget account, FRIESA efficiency index and more
- **Query with precision** — ODSQL filters (`where data>='2025-01'`), facet refinement, field selection, sorting and true offset pagination
- **Latest values instantly** — a dedicated tool that sorts by each dataset's date column and returns the most recent records
- **Lightweight counts** — get record counts without fetching rows

### Why it matters
This is the SNS's own published data — the same numbers behind Portuguese health policy debates: SNS24 call volumes, elective surgery recovery, transplant activity, blood donation, teleconsultation growth and the health service's public account. Filterable to any period and any institution.

### Who is this for?
Healthcare analysts, journalists, policy researchers, students, and AI agents that need authoritative Portuguese national health statistics straight from the source.

## Tools

### list_datasets
Covers SNS24 calls, consultations, surgeries, transplants, blood donors, clinical trials, medicines, the SNS budget account and more. Use page/page_size to navigate — never fetch all pages at once.

List all open data datasets of the Portuguese SNS (national health service) transparency portal

### search_datasets
g. "medicamentos", "transplantes", "cirurgias", "sns24"). Case-insensitive; all words must match.

Search SNS datasets by keyword (id, title or field names)

### get_dataset
Use a dataset_id from list_datasets or search_datasets.

Get full schema and metadata of an SNS dataset (fields, labels, records count)

### query_records
where example: data>='2025-01'; order_by: field name, prefix - for desc (e.g. -data); refine: facet=value (e.g. uf=Hospital de São João); select: comma-separated fields. Returns total_count plus the requested page — combine limit/offset to paginate.

Query records of an SNS dataset with filters (where, refine, order_by) and pagination

### get_latest_records
g. latest SNS24 calls, latest transplants).

Get the most recent records of an SNS dataset (sorted by its date column, descending)

### count_records
Useful before paginating with query_records.

Count records in an SNS dataset (with optional filter), without fetching rows

## Prompt Examples

**Prompt:** 
```
How many emergency calls were transferred to SNS24 recently?
```

**Response:** 
```
🏥 **SNS24 emergency call transfers**

Latest months (dataset sns24):
- 2026-06: 6,766 calls
- 2026-05: 6,812 calls
- 2026-04: 6,950 calls

Series runs monthly since 2012 (174 records). Want the full year-over-year trend or only 2026?
```

**Prompt:** 
```
Find datasets about transplants and show the latest numbers
```

**Response:** 
```
🫀 **Transplant datasets on the SNS portal**

Found 2: `orgaos-colhidos-e-transplantados` (organs harvested & transplanted) and `dadores-vivos-e-falecidos` (living & deceased donors).

Latest records show kidney remains the most transplanted organ, with living-donor activity trending up year over year. Want the breakdown by organ type?
```

**Prompt:** 
```
What is in the SNS account dataset — revenue vs budget?
```

**Response:** 
```
💶 **Dataset: conta-do-servico-nacional-de-saude**

Monthly time series comparing:
- Budget: current revenue, fiscal taxes, direct/indirect taxes, social contributions
- Execution: actual revenue recorded by the SNS

I can pull any month and compute the execution-vs-budget gap. Want the latest month?
```

## Frequently Asked Questions

**Do I need an API key or registration?**
No. The SNS transparency portal's Opendatasoft API is fully public — every tool in this MCP works without authentication.

**Why is there no text-search server-side, and how does search_datasets work?**
The portal's `q` parameter is ignored by this Opendatasoft instance, so search_datasets scans the full 144-dataset catalog client-side (2 requests, cached behavior) and matches your terms against ids, titles, descriptions and column names.