@codespar/mcp-brasil-api

MCP server for BrasilAPI — free public data APIs for CEP, CNPJ, banks, holidays, FIPE, and more

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "brasil-api": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-brasil-api"]
    }
  }
}

Claude Code

claude mcp add brasil-api -- npx @codespar/mcp-brasil-api

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "brasil-api": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-brasil-api"]
    }
  }
}

Tools

| Tool | Description | |------|-------------| | get_cep | Look up address by CEP (Brazilian postal code) | | get_cnpj | Look up company information by CNPJ | | get_banks | List all Brazilian banks with codes and names | | get_holidays | List national holidays for a given year | | get_fipe_brands | List vehicle brands by type from FIPE table | | get_fipe_price | Get vehicle price from FIPE table by code | | get_ddd | Get state and cities for a DDD (area code) | | get_isbn | Look up book information by ISBN | | get_ncm | Look up NCM tax classification code | | get_cptec_weather | Get weather forecast for a city (CPTEC/INPE) |

Authentication

No authentication required. BrasilAPI is a free public API.

Sandbox / Testing

No sandbox needed. BrasilAPI is free and open for all requests.

Get your credentials

No credentials needed. Just install and use.

Environment Variables

No environment variables required.

Roadmap

v0.2 (planned)

• get_pix_participants — Get list of Pix participant institutions
• get_domain_info — Get domain registration info
• get_vehicle_info — Get vehicle info by license plate (FIPE)
• get_ibge_municipalities — List municipalities by state (IBGE)
• get_tax_rates — Get current tax rates (Selic, CDI, IPCA)

v0.3 (planned)

• get_cvm_funds — Get investment fund data from CVM
• get_election_results — Get election results by region

Want to contribute? Open a PR or request a tool.

Links

• BrasilAPI Website
• BrasilAPI Documentation
• MCP Dev Brasil
• Landing Page

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT