mcp-pt

[!IMPORTANT] This is an unofficial community project. It is not affiliated with the data providers (DGEG, IPMA, INE, GeoAPI.pt, AMA/dados.gov.pt). Respect each provider's terms — in particular, DGEG fuel data is for non-commercial use.

What it does

Ask your AI assistant things like:

• "What's the cheapest diesel station in the Lisbon district?"

• "Will it rain tomorrow in Porto? Are there active weather warnings?"

• "Which locality has the postal code 1990-096?"

• "How many inhabitants did Portugal have in the 2021 Census?"

• "Search dados.gov.pt for datasets about the environment."

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

Related MCP server: IPMA MCP Server

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