Mcp Brasil Api

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for BrasilAPI — CEP, CNPJ, banks, FIPE, holidays, weather

VerifiedSTDIODesktop onlyLocation & Lifestyle Finance Business & Commerce

Server details

Identifier: io.github.codespar/mcp-brasil-api
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account codespar for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.codespar%2Fmcp-brasil-api.svg)](https://sourceweft.com/mcp/io.github.codespar%2Fmcp-brasil-api?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server exposing BrasilAPI lookups: Brazilian postal codes, companies, banks, FIPE vehicle prices, holidays, weather and more.

What you can do: Look up Brazilian addresses by CEP and company data by CNPJ
List banks, Pix participants and CVM-registered brokerages
Query FIPE reference tables, vehicle brands, models and prices
Retrieve holidays, IBGE states and municipalities, DDD area codes, NCM codes, ISBN book data and .br domain info
Get weather forecasts, capital and airport conditions and ocean forecasts from CPTEC/INPE
Fetch current Brazilian economic rates such as Selic, CDI and IPCA
When to use it: Useful when an assistant needs Brazilian public reference data — validating addresses or company records, checking vehicle prices, holidays, tax rates or local weather — without building API calls by hand.
Requirements: Runs locally over stdio, typically launched with npx from the npm package @codespar/mcp-brasil-api, so Node.js and network access to BrasilAPI are needed. No authentication, API keys or environment variables are required.

Before you install

All tools are read-only lookups against a free public API; queries (such as CEP, CNPJ or domain names) are sent to BrasilAPI's third-party servers. The README also mentions a separate paid enterprise offering, which is not part of this server.

Installation

In SourceWeft

Open Mcp Brasil Api in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-brasil-api

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

[npm] [License: MIT]

Quick Start

Claude Desktop

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

json

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

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

Claude Code

Cursor / VS Code

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

json

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

{  "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.

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

Source: packages/identity/brasil-api/README.md at commit d0a519a

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts