Provides tools for interacting with the Pix (Brazilian instant payment system) API, enabling listing of participants.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-brasilapi query CEP 01310-100"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
uv syncRelated MCP server: brasilapi-mcp
stdio (padrão, para Claude Desktop / clientes locais):
python -m mcp_brasilapi
# ou
mcp-brasilapistreamable-http (para clientes remotos):
TRANSPORT=http PORT=8000 python -m mcp_brasilapiO endpoint fica disponível em http://localhost:8000/mcp.
Var | Default | Descrição |
|
| URL base da API |
|
|
|
|
| Bind do transporte HTTP |
| — | Sobrescreve o TTL padrão do cache (segundos) |
|
|
|
|
| Máx. requisições concorrentes |
|
| Máx. requisições por segundo |
Cada ferramenta usa prefixo por recurso. 41 tools em 18 grupos:
Grupo | Tools |
CEP |
|
CNPJ |
|
DDD |
|
IBGE |
|
Bancos |
|
PIX |
|
FIPE |
|
NCM |
|
Câmbio |
|
Taxas |
|
CPTEC |
|
CVM |
|
Feriados |
|
ISBN |
|
RegistroBR |
|
Tickers B3 |
|
TUSS |
|
Veja docs/SPEC.md para o mapa de endpoints e o roadmap por fases.
Busca um banco a partir do seu código (ex.: 1 = Banco do Brasil).
Inputs: code (required). Returns: object
Lista todos os bancos do Brasil.
Returns:
Lista de bancos com code, name e fullName.
Inputs: no named parameters. Returns: result
Consulta a cotação do Real em relação a uma moeda em uma data.
Inputs: data (required), moeda (required). Returns: object
Lista todas as moedas disponíveis para consulta de câmbio.
Returns:
Lista de moedas com simbolo e nome.
Inputs: no named parameters. Returns: result
Busca o endereço correspondente a um CEP (8 dígitos, com ou sem hífen).
Inputs: cep (required). Returns: object
Busca um CEP incluindo geolocalização (latitude/longitude e timezone).
Inputs: cep (required). Returns: object
Consulta dados cadastrais de uma empresa pelo CNPJ (Receita Federal via Minha Receita).
Inputs: cnpj (required). Returns: object
Busca uma corretora pelo CNPJ nos arquivos da CVM.
Inputs: cnpj (required). Returns: object
Lista as corretoras de valores registradas na CVM.
Returns: Lista de corretoras com CNPJ e dados cadastrais.
Inputs: no named parameters. Returns: result
Busca localidades (cidades) pelo nome no CPTEC.
Inputs: nome (required). Returns: result
Condições climáticas atuais em um aeroporto (código ICAO).
Inputs: icao (required). Returns: object
Condições climáticas atuais nas capitais brasileiras.
Returns: Lista com clima atual de cada capital.
Inputs: no named parameters. Returns: result
Lista as localidades (cidades) disponíveis no CPTEC.
Returns:
Lista de cidades com id e nome (usado nas previsões).
Inputs: no named parameters. Returns: result
Previsão oceânica (ondas) para uma cidade litorânea.
Inputs: codigo (required), dias. Returns: object
Previsão meteorológica para uma cidade.
Inputs: codigo (required), dias. Returns: object
Previsão meteorológica com base em latitude e longitude.
Inputs: lat (required), long (required). Returns: object
Retorna o estado (UF) e a lista de cidades que usam um DDD.
Inputs: ddd (required). Returns: object
Lista os feriados nacionais de um ano (inclui feriados móveis).
Inputs: ano (required). Returns: result
Consulta o preço de um veículo segundo a tabela FIPE.
Inputs: codigo_fipe (required). Returns: object
Lista as marcas de veículos para um tipo (carro, moto ou caminhao).
Inputs: tipo_veiculo (required). Returns: result
Lista as tabelas de referência da FIPE (meses de referência disponíveis).
Returns:
Lista de tabelas com codigo e mes.
Inputs: no named parameters. Returns: result
Lista os veículos de uma marca conforme o tipo.
Inputs: codigo_marca (required), tipo_veiculo (required). Returns: result
Busca detalhes de um fundo pelo CNPJ na CVM.
Inputs: cnpj (required). Returns: object
Lista os fundos de investimento registrados na CVM.
Returns: Lista de fundos com CNPJ e dados cadastrais.
Inputs: no named parameters. Returns: object
Busca os dados de uma UF a partir da sigla ou do código IBGE.
Inputs: code (required). Returns: object
Lista os municípios de uma unidade federativa.
Inputs: sigla_uf (required), providers. Returns: result
Lista todas as unidades federativas (estados) do Brasil.
Returns:
Lista de UFs com id, sigla, nome, regiao e estimativa populacional.
Inputs: no named parameters. Returns: result
Busca informações de um livro a partir do ISBN.
Inputs: isbn (required). Returns: object
Busca um NCM a partir do código exato.
Inputs: code (required). Returns: object
Lista todos os códigos NCM (Nomenclatura Comum do Mercosul).
Returns:
Lista completa de NCMs com codigo, descricao e dados de vigência.
Inputs: no named parameters. Returns: result
Pesquisa NCMs por código parcial ou palavra-chave na descrição.
Inputs: termo (required). Returns: result
Lista os participantes do PIX (dados do Banco Central).
Returns:
Lista de participantes com ispb, nome, nome_reduzido,
modalidade_participacao e tipo_participacao.
Inputs: no named parameters. Returns: result
Avalia o status de um domínio .br junto ao Registro.br.
Inputs: domain (required). Returns: object
Busca uma taxa a partir da sua sigla (ex.: "SELIC", "CDI", "IPCA").
Inputs: sigla (required). Returns: object
Lista as taxas de juros e índices oficiais do Brasil.
Returns:
Lista de taxas com sigla, nome e valor.
Inputs: no named parameters. Returns: result
Lista os tickers das empresas listadas na B3 (ações).
Returns:
Lista de tickers com codigo, nome e tipo.
Inputs: no named parameters. Returns: result
Lista os tickers de fundos de investimento listados na B3.
Inputs: type_fund (required). Returns: result
Autocomplete de termos TUSS para preenchimento em UIs/agentes.
Inputs: q, name, tuss, limit. Returns: result
Detalha um termo TUSS pelo código.
Inputs: code (required). Returns: object
Lista termos da TUSS (Terminologia Unificada da Saúde Suplementar).
Inputs: name, tuss, limit, offset. Returns: object
Busca avançada de termos TUSS.
Inputs: q, name, tuss, limit, +2 more. Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 41 tools
Each tool has a clearly distinct purpose, grouped by domain (e.g., bancos, cep, fipe) with specific actions like buscar, listar, pesquisar. No two tools overlap in functionality; an agent can easily select the correct one.
Tools follow a consistent domain__verb pattern in snake_case (e.g., bancos__buscar, cep__listar). One minor deviation is cep__buscar_v2, which breaks the verb-only pattern but is still understandable.
41 tools is high but justified given the server aggregates many distinct Brazilian public APIs (banks, CEP, CNPJ, weather, FIPE, IBGE, etc.). Each tool serves a specific query, and the number reflects the breadth of available data.
The tool surface covers key CRUD-like operations for each domain (list, get, search) and even includes advanced features like geolocation CEP and wave prediction. Minor gaps exist (e.g., no explicit update/delete for any domain, but these are read-only APIs).
Brazil CNPJ, CEP, Selic/IPCA/PTAX, holidays, banks/ISPB for agents. Pay per call in USDC (x402).
Open Finance API and MCP discovery for developers and AI agents building in Brazil.
Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.