Brasilapi

FreeNot checked

Exposes the BrasilAPI as MCP tools, enabling AI agents to query Brazilian public data such as CEP, CNPJ, DDD, IBGE, banks, PIX, FIPE, NCM, exchange rates, taxes

by silasrm

GitHub Embed

About

Exposes the BrasilAPI as MCP tools, enabling AI agents to query Brazilian public data such as CEP, CNPJ, DDD, IBGE, banks, PIX, FIPE, NCM, exchange rates, taxes, weather, CVM information, holidays, ISBN, domains, stock tickers, and TUSS.

README

Servidor MCP em Python que expõe a BrasilAPI como ferramentas para agentes de IA: CEP, CNPJ, DDD, IBGE, bancos, PIX, FIPE, NCM, câmbio, taxas, clima (CPTEC), corretoras/fundos CVM, feriados, ISBN, RegistroBR, tickers B3 e TUSS.

Instalação

uv sync

Execução

stdio (padrão, para Claude Desktop / clientes locais):

python -m mcp_brasilapi
# ou
mcp-brasilapi

streamable-http (para clientes remotos):

TRANSPORT=http PORT=8000 python -m mcp_brasilapi

O endpoint fica disponível em http://localhost:8000/mcp.

Configuração (variáveis de ambiente)

Var	Default	Descrição
`BRASILAPI_BASE_URL`	`https://brasilapi.com.br/api`	URL base da API
`TRANSPORT`	`stdio`	`stdio` ou `http`/`streamable-http`
`HOST` / `PORT`	`0.0.0.0` / `8000`	Bind do transporte HTTP
`BRASILAPI_CACHE_TTL`	—	Sobrescreve o TTL padrão do cache (segundos)
`BRASILAPI_CACHE`	`1`	`0` desliga o cache
`BRASILAPI_MAX_CONCURRENCY`	`10`	Máx. requisições concorrentes
`BRASILAPI_RATE_PER_SEC`	`10`	Máx. requisições por segundo

Ferramentas

Cada ferramenta usa prefixo por recurso. 41 tools em 18 grupos:

Grupo	Tools
CEP	`cep__buscar`, `cep__buscar_v2`
CNPJ	`cnpj__buscar`
DDD	`ddd__buscar`
IBGE	`ibge__listar_ufs`, `ibge__buscar_uf`, `ibge__listar_municipios`
Bancos	`bancos__listar`, `bancos__buscar`
PIX	`pix__listar_participantes`
FIPE	`fipe__listar_tabelas`, `fipe__listar_marcas`, `fipe__listar_veiculos`, `fipe__consultar_preco`
NCM	`ncm__listar`, `ncm__buscar`, `ncm__pesquisar`
Câmbio	`cambio__listar_moedas`, `cambio__consultar_cotacao`
Taxas	`taxas__listar`, `taxas__buscar`
CPTEC	`cptec__listar_cidades`, `cptec__buscar_cidade`, `cptec__clima_capitais`, `cptec__clima_aeroporto`, `cptec__previsao_cidade`, `cptec__previsao_coordenadas`, `cptec__ondas_cidade`
CVM	`corretoras__listar`, `corretoras__buscar`, `fundos__listar`, `fundos__buscar`
Feriados	`feriados__listar`
ISBN	`isbn__buscar`
RegistroBR	`registrobr__consultar`
Tickers B3	`tickers__listar_acoes`, `tickers__listar_fundos`
TUSS	`tuss__listar`, `tuss__buscar`, `tuss__pesquisar`, `tuss__autocomplete`

Veja docs/SPEC.md para o mapa de endpoints e o roadmap por fases.

from github.com/silasrm/mcp-brasilapi

Install Brasilapi in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install mcp-brasilapi

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add mcp-brasilapi -- uvx --from git+https://github.com/silasrm/mcp-brasilapi mcp-brasilapi

FAQ

Is Brasilapi MCP free?

Yes, Brasilapi MCP is free — one-click install via Unyly at no cost.

Does Brasilapi need an API key?

No, Brasilapi runs without API keys or environment variables.

Is Brasilapi hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Brasilapi in Claude Desktop, Claude Code or Cursor?

Open Brasilapi on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Fetch

Web content fetching and conversion for efficient LLM usage.

by Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

by modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.

by Community

llm-analysis-assistant

A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also

by xuzexin-hz

Compare Brasilapi with

BrasilapivsFetch BrasilapivsAWS KB Retrieval BrasilapivsSpring AI MCP Server Brasilapivsllm-analysis-assistant

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs