query-ptax-bcb

MCP (Model Context Protocol) server that exposes the official PTAX dollar exchange rate by directly querying the open data API of the Central Bank of Brazil (BCB): https://olinda.bcb.gov.br/olinda/servico/PTAX/versao/v1/odata/

Tools

• get_ptax_by_date(date) — official PTAX closing rate for a specific date (YYYY-MM-DD).

• get_ptax_by_period(startDate, endDate) — series of closing rates between two dates.

• get_ptax_latest(lookbackDays?) — most recent available closing rate (searches the last lookbackDays days, default 7).

All returned rates are the closing (official PTAX) bulletin, with buy, sell, and quote time (Brasília time).

Related MCP server: Frankfurter MCP

Build

npm install
npm run build

Testing with the MCP Inspector

npm run inspector

Configure in Claude Desktop / Claude Code

Add to the MCP configuration file (claude_desktop_config.json or equivalent):

{
  "mcpServers": {
    "query-ptax-bcb": {
      "command": "node",
      "args": ["D:/GitHub/master-mils/query-ptax-bcb/dist/index.js"]
    }
  }
}