Skip to main content
BR

Brasil API

v0.2.1No Auth

Brazilian public data: CEP lookup, CNPJ validation, bank codes, FIPE vehicle prices, holidays, and tax tables. No auth required.

24 tools0 env varsπŸ‡§πŸ‡· Brazilstable on npm

What your agent can do

Brasil API gives your agent 24 tools it calls directly β€” pick the ones it needs, in Claude, Cursor, or any MCP client.

  • 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
Example call
// Your agent calls a tool directly β€” no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("get_cep", { /* ... */ });

Install

terminal
$ npm install @codespar/mcp-brasil-api

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

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

After restart, your agent can call any of the 24 tools below β€” try get_cep first.

Available tools Β· 24

Each tool is independent β€” your agent loads only what it needs to reduce context and response time.

READget_cep
Look up address by CEP (Brazilian postal code)
READget_cnpj
Look up company information by CNPJ
READget_banks
List all Brazilian banks with codes and names
READget_holidays
List national holidays for a given year
READget_fipe_brands
List vehicle brands by type from FIPE table
READget_fipe_price
Get vehicle price from FIPE table by code
READget_ddd
Get state and cities for a DDD (area code)
READget_isbn
Look up book information by ISBN

Compatible frameworks

MCP is a protocol β€” any framework that speaks it can mount this server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Frequently asked questions

Run `npx -y @codespar/mcp-brasil-api` and add the config block above to your MCP client β€” Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Brasil API β€” MCP server Β· 24 tools | CodeSpar