Brasil API

v0.2.0No 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

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

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.