About mcp-brasil-api
An MCP server that makes BrasilAPI public data queries available to AI agents. It requires no authentication and covers Brazilian postal codes, companies, banks, holidays, vehicle prices, weather, and more.
Key features
- 01Provides 24 query tools
- 02Look up CEP addresses and CNPJ companies
- 03Query banks, holidays, and FIPE vehicle data
- 04Retrieve weather, tax rates, and IBGE data
- 05No API key or environment variables required
Use cases
- 01Find a Brazilian address by CEP
- 02Look up company details by CNPJ
- 03Check a vehicle's FIPE price
- 04Get city weather or annual holidays
MCP support
Wraps BrasilAPI public-data queries as tools for MCP clients. No authentication is required.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
24Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| cep | string | Yes | CEP (8 digits, e.g. 01001000) |
Details
From the project README@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 (24)
| 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.