Finance (Brazil)

Signed, verified Brazilian financial data as MCP tools for Claude. SELIC, CDI, IPCA, IGP-M, USD/BRL, EUR/BRL, B3 stocks, and Copom decisions.

Endpoint: https://finance.mcp.signed-data.org/mcp Domain spec: finance.brazil

Quick start

Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "signeddata-finance": {
      "url": "https://finance.mcp.signed-data.org/mcp"
    }
  }
}

Or test via curl:

curl -X POST https://finance.mcp.signed-data.org/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

pip install signeddata-cds
pip install "git+https://github.com/signed-data/cds.git#subdirectory=mcp/finance"
signeddata-mcp-finance

Then add to Claude Desktop:

{
  "mcpServers": {
    "signeddata-finance": {
      "command": "signeddata-mcp-finance"
    }
  }
}

git clone https://github.com/signed-data/cds.git && cd cds
pip install -e sdk/python
pip install -e mcp/finance
signeddata-mcp-finance

Tools

Tool	Description
`get_selic_rate`	SELIC overnight rate (last N days)
`get_ipca`	IPCA consumer price index (monthly + 12-month)
`get_igpm`	IGP-M general price index
`get_usd_brl`	USD/BRL PTAX exchange rate (buy/sell)
`get_fx_rates`	USD/BRL + EUR/BRL at once
`get_stock_quote`	B3 stock quotes — up to 10 tickers
`get_market_summary`	SELIC + USD/BRL in one call
`get_copom_history`	Last N Copom monetary-policy decisions
`get_copom_latest`	Most recent Copom decision

Resources

URI	Description
`finance://selic/latest`	Latest SELIC rate
`finance://usd-brl/latest`	Latest USD/BRL PTAX
`finance://ipca/latest`	Latest IPCA index
`finance://market-summary`	Market summary

HTTP API

The deployed endpoint also exposes individual tools as HTTP routes for quick testing:

# Service info
curl https://finance.mcp.signed-data.org/

# SELIC rate
curl https://finance.mcp.signed-data.org/tool/get_selic_rate

# Stock quote
curl "https://finance.mcp.signed-data.org/tool/get_stock_quote?tickers=PETR4,VALE3"

# USD/BRL (last 5 days)
curl "https://finance.mcp.signed-data.org/tool/get_usd_brl?last_n=5"

# Latest Copom decision
curl https://finance.mcp.signed-data.org/tool/get_copom_latest

Data sources

Source	URL	Auth
Banco Central do Brasil (SGS)	`api.bcb.gov.br`	None (public domain)
Brapi (B3 quotes)	`brapi.dev/api`	None (free tier, 15 req/min)
BCB Copom	`bcb.gov.br`	None

Environment variables

Variable	Description	Default
`CDS_PRIVATE_KEY_PATH`	Path to RSA private key for signing	(unsigned if not set)
`CDS_PUBLIC_KEY_PATH`	Path to RSA public key for verification	(skip verification)
`CDS_ISSUER`	Issuer URI in signed events	`signed-data.org`