portugal-mcp

Portugal's public data for AI assistants, in one MCP server. Ask Claude (or any MCP client) about the weather and warnings, a postal code, unemployment or inflation, the Euribor, what Parliament voted, who won a public contract, how busy the emergency rooms were, whether a medicine is in shortage, the cheapest fuel nearby or when the next bus comes.

Read-only, no API keys, no accounts. Every answer comes from an official or public open-data source and says which one and for which date. Not affiliated with any of the sources.

Português: servidor MCP com os dados públicos de Portugal (IPMA, INE, Banco de Portugal, Parlamento, Portal BASE, dados.gov.pt, SNS, Infarmed, DGEG, MOBI.E, Carris Metropolitana). Só leitura, sem chaves. As ferramentas aceitam perguntas em português.

What it covers

There are 42 tools in total. If your client struggles with that many, load only what you need with PORTUGAL_MCP_FEATURES (see below).

Things to know

• Statistics are dated. INE, BPstat and SNS figures are official series with a reference period, often a few months back. Answers quote the period.
• Health and medicines: information, not advice. SNS figures are monthly statistics, not live emergency-room queues. Per-pharmacy stock is not public in Portugal, so the tools never claim a pharmacy has a medicine. In an emergency call 112; for health advice call SNS 24, 808 24 24 24.
• Parliament: votes are recorded per parliamentary group, as the Parliament publishes them. The first call downloads about 100 MB (roughly a minute), then it is cached for a day.
• Public contracts: the yearly BASE files are 15-55 MB, so the first query for a year takes a minute or two. Amounts are contract prices without VAT as reported by the buyer. Tax numbers (NIF) of individual people are hidden; company and public-body NIFs are shown.
• Fuel / EV: the first EV query loads the national MOBI.E feed (about 80 s), then it is cached.

Install

Needs Python 3.10+. With uv nothing else is required:

uvx portugal-mcp --list-tools

Or with pip: pip install portugal-mcp.

Claude Code

claude mcp add portugal -- uvx portugal-mcp

Claude Desktop

Add this to claude_desktop_config.json (also in claude_desktop_config.snippet.json):

{
  "mcpServers": {
    "portugal": {
      "command": "uvx",
      "args": ["portugal-mcp"]
    }
  }
}

Codex and other MCP clients

Any client that runs stdio servers works: command uvx, args ["portugal-mcp"]. For HTTP, run portugal-mcp --http, which serves streamable HTTP on 127.0.0.1:8000 (change it with MCP_HOST / MCP_PORT).

Configuration

portugal-mcp --refresh downloads the large files ahead of time (Parliament, this year's contracts, EV chargers) and then exits.

Example questions

• "Vai chover no Porto esta semana? Há avisos?"
• "Qual é o risco de incêndio hoje em Monchique?"
• "What's the unemployment rate in Portugal, latest month?"
• "Como evoluiu a Euribor a 6 meses nos últimos 12 meses?"
• "O que o Parlamento votou sobre habitação este mês, e como votou cada partido?"
• "Quais os maiores ajustes diretos de 2026? Quanto a Câmara de Lisboa contratou este ano?"
• "Preciso de ibuprofeno em Coimbra — está em rutura? Que farmácias estão de serviço?"
• "Gasóleo mais barato perto de Setúbal" / "Carregadores rápidos perto do Marquês"
• "Quando passa o próximo autocarro na paragem do Cais do Sodré?"

Development

python -m venv .venv && .venv/bin/pip install -e ".[dev]"
pytest              # offline unit tests (fixtures, no network)
pytest -m live      # hits every real source; CI runs this daily
ruff check .

CONTRIBUTING.md explains how features are laid out and the rules for adding a source. SECURITY.md explains how to report a vulnerability.

Maintenance

• CI: lint and unit tests on Linux and Windows for every push and pull request, plus pip-audit.
• Live sources: a daily run against the real APIs that opens an issue when a source changes its format.
• Dependabot: proposes dependency and GitHub Actions updates. Actions are pinned by commit SHA.
• Releases: only from a version tag, and only after the tests pass. Publishing goes through PyPI trusted publishing and the official MCP Registry, with no stored tokens.

Replaces

This package merges four earlier servers by the same author, which are now deprecated: sns-portugal-mcp, portugal-medicines-mcp, portugal-fuel-ev-mcp and carris-metropolitana-mcp. Their tools continue here. The SNS, medicine and bus tools now carry a prefix (sns_, medicine_, bus_) so they stay unambiguous among 42 tools.

License

MIT. The data belongs to its publishers and is used under their open-data terms; please credit them when you reuse it.