mcp-brasilapi

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.