What it does

Ask your AI assistant things like:

• "Qual o posto de gasóleo mais barato no distrito de Lisboa?"

• "Vai chover amanhã no Porto? Há avisos meteorológicos ativos?"

• "Que localidade tem o código postal 1990-096?"

• "Quantos habitantes tinha Portugal nos Censos 2021?"

• "Procura datasets sobre ambiente no dados.gov.pt."

…and it will call the right tool, hit the public API, and answer with real data.

Install

Run it with npx (no install needed) — just point your MCP host at it.

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

{
  "mcpServers": {
    "pt": {
      "command": "npx",
      "args": ["-y", "mcp-pt"]
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (or the project's .cursor/mcp.json):

{
  "mcpServers": {
    "pt": { "command": "npx", "args": ["-y", "mcp-pt"] }
  }
}

Any MCP host

The server speaks MCP over stdio. Launch npx -y mcp-pt (or node dist/index.js from a clone) as the server command.

Tools

All tools call free, public APIs and need no API keys.

Example (raw MCP)

# List the tools over stdio
printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"x","version":"0"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | npx -y mcp-pt

How it relates to the SDKs

mcp-pt is the AI-facing layer over a family of standalone, multi-language SDKs for the same data — precos-combustiveis-pt, ipma-api, geoapi-pt-sdk, ine-pt and dados-gov-pt. The server is self-contained (it calls the APIs directly), so it has no dependency on those packages.

Develop

npm install
npm test        # vitest
npm run build   # tsup → dist/index.js (executable)
node dist/index.js

FAQ

No. Every tool uses a free, public Portuguese API.

No — it's an independent community project. Please respect each provider's terms (DGEG fuel data is non-commercial).

Anything that speaks MCP over stdio — Claude Desktop, Cursor, Continue, and custom clients using the MCP SDK.

License

MIT © Marcelo Domingues