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.