mcp-brasil
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BRASILAPI_BASE_URL | No | Para usar um espelho ou uma instância própria | https://brasilapi.com.br/api |
| BRASILAPI_TIMEOUT_MS | No | Timeout por requisição | 15000 |
| BRASILAPI_CACHE_TTL_MS | No | Cache em memória (5 min); `0` desativa | 300000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Ferramentas com dados públicos do Brasil via BrasilAPI. Use validar_documento antes de consultar_cnpj quando não tiver certeza do número; para prazos e vencimentos, use calcular_prazo ou calcular_dias_uteis em vez de contar dias manualmente.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| consultar_cepA | Busca o endereço de um CEP brasileiro (rua, bairro, cidade, UF e, quando houver, coordenadas). Aceita com ou sem hífen. |
| consultar_cnpjA | Consulta os dados públicos de uma empresa na Receita Federal: razão social, situação cadastral, endereço, CNAE, porte, Simples/MEI e quadro de sócios. |
| validar_documentoA | Valida localmente (sem internet) os dígitos verificadores de um CPF ou CNPJ, inclusive o CNPJ alfanumérico em vigor desde 2026, e devolve o número formatado. Não consulta se o documento existe. |
| buscar_bancoA | Procura bancos e instituições de pagamento pelo código COMPE (ex.: 260) ou por parte do nome (ex.: nubank). Retorna código, ISPB e nome completo. |
| consultar_taxasA | Retorna o valor atual das taxas de referência (Selic, CDI e IPCA, em % ao ano). Sem sigla, retorna todas. |
| feriados_nacionaisA | Lista os feriados nacionais de um ano (inclui Carnaval, Sexta-feira Santa e Corpus Christi), com o dia da semana de cada um. |
| calcular_dias_uteisA | Conta os dias úteis entre duas datas (inclusive), descontando fins de semana e feriados nacionais. Útil para prazos, SLAs e boletos. Não considera feriados estaduais ou municipais. |
| calcular_prazoA | Calcula a data final de um prazo: soma N dias úteis a uma data (pulando fins de semana e feriados nacionais, sem contar o dia inicial) ou N dias corridos (prorrogando para o próximo dia útil se cair em fim de semana ou feriado). Use para vencimentos, SLAs e prazos contratuais. Não considera feriados estaduais ou municipais. |
| consultar_dddB | Retorna a UF e a lista de cidades atendidas por um código DDD. |
| listar_municipiosA | Lista os municípios de um estado com o código IBGE de cada um. Aceita filtro por nome. |
| fipe_marcasA | Lista as marcas de veículos da Tabela FIPE por tipo (carros, motos ou caminhões). Aceita filtro por nome. |
| fipe_precoA | Consulta o preço médio de um veículo na Tabela FIPE pelo código FIPE (ex.: 001004-9), em todos os anos-modelo disponíveis. |
| consultar_dominio_brA | Verifica no Registro.br se um domínio .br está disponível ou registrado (com data de expiração e sugestões). |
| consultar_isbnA | Busca título, autores, editora, ano e sinopse de um livro pelo ISBN-10 ou ISBN-13. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Each tool targets a clearly distinct resource or operation: CEP lookup, CNPJ lookup, CPF/CNPJ validation, bank search, tax rates, holidays, DDD, municipalities, FIPE, domains, ISBN. The closest pair, calcular_prazo and calcular_dias_uteis, is disambiguated by their descriptions (end-date projection vs. business-day counting). validar_documento vs. consultar_cnpj is also clearly split (local checksum vs. Receita Federal lookup).
Most tools follow a Portuguese verb_noun pattern (consultar_cep, calcular_prazo, buscar_banco, listar_municipios, validar_documento). A few deviate: feriados_nacionais is noun-only, and fipe_marcas/fipe_preco use a domain prefix instead of a verb. Still predictable enough for an agent to infer behavior.
14 tools sit squarely in the well-scoped range and each covers a distinct Brazilian data source or calculation. There is no filler tool, and the set is not so large that selection becomes unwieldy.
Coverage of CEP, CNPJ, banks, taxes, holidays and DDD/IBGE data is solid, but FIPE is a dead end: fipe_marcas lists brands and fipe_preco needs a FIPE code, yet there is no tool to discover models/years/codes. Other notable gaps include no reverse address/CEP search and no municipality-to-IBGE lookup beyond per-state listing.