# Dados.gov.pt Open Data AI Agent Connect

> Portugal's national open data catalog: search 20,000+ datasets from ministries, municipalities and public bodies, inspect resources, preview CSV/JSON data and browse publishing organizations — all zero-auth.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_4h8EtS4ad3O1dUdlAlXYI5FqvaSJFl9f7BFTMu9a/ai-agent-connect
- **Tags:** open-data, portugal, public-sector, government-data, transparency, statistics

## Description

The **official Portuguese public sector open data portal** (dados.gov.pt) as a single MCP server.

### What you can do
- **Discover** — full-text search across 20,000+ open datasets covering health, tourism, finance, municipalities, environment and more
- **Inspect** — complete dataset metadata: resources, formats, licenses, spatial/temporal coverage, quality metrics
- **Preview data** — fetch actual CSV/JSON resource content through the portal's proxy, with size-capped previews
- **Browse publishers** — search ministries, municipalities (Câmara Municipal), institutes and agencies; inspect each organization's profile
- **Curated picks** — list the portal's featured datasets

### Who is this for?
Analysts, journalists, researchers and AI agents that need authoritative Portuguese public data: statistics, budgets, health indicators, municipal transparency and more — all published under open licenses, no authentication required.

## Tools

### list_featured_datasets
gov.pt team as featured. Useful for discovery and inspiration.

List featured/highlighted open data datasets

### search_datasets
gov.pt. Returns id, title, slug, organization, tags, formats and last update. Use page to navigate results (never fetch all pages).

Search open data datasets from the Portuguese public sector (20,000+ datasets)

### get_dataset
Get full metadata of a dataset (resources, license, coverage, quality)

### get_resource
gov.pt proxy and returns a text preview. Use get_dataset first to find resource ids. Large files are truncated to max_chars characters.

Fetch the actual data of a dataset resource (CSV/JSON preview)

### search_by_tag
Returns id, title, slug, organization and formats. Use page to navigate.

Search datasets by tag (e.g. "turismo", "saude")

### search_by_format
The format is case-sensitive and lowercase (e.g. "csv", "json", "shp", "xlsx") — note that many publishers do not tag formats, so combine with search_datasets for full coverage.

Search datasets offering a specific file format (csv, json, xlsx...)

### search_organizations
gov.pt organizations by name. Returns id, name, acronym, description and dataset counts. Use the id in get_organization.

Search public bodies publishing open data (ministries, municipalities...)

### get_organization
Combine with search_datasets (query=org name) to list its datasets.

Get full profile of a publishing organization

## Prompt Examples

**Prompt:** 
```
Find open data about tourism in Portugal and tell me what formats are available
```

**Response:** 
```
🇵🇹 **Tourism datasets on dados.gov.pt**

39 datasets found. Highlights:
- **Dormidas e proveitos na alojamento** (INE) — monthly hotel stays & revenue, CSV + JSON
- **PME Turismo de Portugal** — funding beneficiaries, CSV
- **Proveitos do turismo receiver** — regional revenue series

Most offer CSV; INE-sourced datasets also expose JSON indicator APIs. I can preview any of them next.
```

**Prompt:** 
```
Which municipalities publish open data and how much have they published?
```

**Response:** 
```
🏛️ **Municipal open data publishers**

Top publishers found:
- **Câmara Municipal de Lisboa** — dozens of datasets (mobility, equipment, environment)
- **Câmara Municipal do Porto** — urban data portal mirrors
- **Cascais**, **Aveiro**, **Braga** — growing catalogs

I can drill into any municipality's profile or list its datasets next.
```

**Prompt:** 
```
Preview the first rows of the health indicators dataset about pharmacists per 1000 inhabitants
```

**Response:** 
```
💊 **Pharmacists per 1000 inhabitants (INE)**

Preview of the JSON resource:
```
IndicadorCod: 0014855
Distribuição: Local de trabalho (NUTS - 2024)
Periodicidade: Anual
```
First data rows show values by NUTS region with latest year available. The full file is ~1MB of JSON — I can pull more rows or filter by region if you want.
```

## Frequently Asked Questions

**Do I need an API key or registration?**
No. dados.gov.pt is a fully open portal — every tool in this MCP works without any authentication or account.

**Can I download the actual data files?**
The get_resource tool previews a resource's content through the portal's proxy (truncated to keep responses manageable). For very large files, use the resource URL from get_dataset to fetch data in chunks.