@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"]
}
}
}
| Tool | Purpose |
|---|
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) |
get_pix_participants | List Pix participant institutions (PSPs/banks enrolled in Pix) |
get_domain_info | Look up .br domain registration info |
get_ibge_municipalities | List all municipalities for a Brazilian state (IBGE data) |
get_tax_rates | Get current Brazilian tax/economic rates (Selic, CDI, IPCA) |
get_cptec_cities | Search CPTEC/INPE cities by name for weather forecasts |
get_cep_v1 | Look up address by CEP using BrasilAPI v1 (single-provider, often faster than v2) |
get_fipe_vehicles | List vehicle models for a given FIPE brand code and vehicle type |
get_fipe_tables | List FIPE reference tables (months/years available for FIPE queries) |
get_cptec_airport_weather | Get current airport weather (METAR) by ICAO code from CPTEC/INPE |
get_cptec_capitals_weather | Get current weather conditions for all Brazilian state capitals |
get_cptec_ocean_forecast | Get ocean/wave forecast for a coastal city (CPTEC/INPE) |
get_ibge_states | List all Brazilian states/UFs with IBGE codes and metadata |
get_corretoras | List all CVM-registered Brazilian brokerages (corretoras) |
get_corretora | Look up a single CVM-registered brokerage by CNPJ |
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 institutionsget_domain_info — Get domain registration infoget_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 CVMget_election_results — Get election results by region
Want to contribute? Open a PR or request a tool.
Links
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