@codespar/mcp-brasil-api

@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 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