mcp-server-brasil
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_ALLOWED_HOSTS | No | Allowed Host header values for DNS rebinding protection when running the Streamable HTTP transport (for example, localhost:8000). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Ferramentas para dados públicos do Brasil: endereço por CEP, dados cadastrais de CNPJ (inclusive alfanumérico), validação offline de CPF/CNPJ, feriados nacionais, contagem de dias úteis, indicadores do Banco Central (Selic, CDI, IPCA, IGP-M, dólar, euro), municípios do IBGE e cidades por DDD. Datas no formato ISO (AAAA-MM-DD).
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| consultar_cepC | Endereço (logradouro, bairro, cidade, UF e coordenadas quando houver) de um CEP. |
| consultar_cnpjB | Dados cadastrais públicos de uma empresa na Receita Federal a partir do CNPJ. |
| validar_documentoA | Valida os dígitos verificadores de um CPF ou CNPJ (numérico ou alfanumérico), sem rede. |
| feriados_nacionaisB | Feriados nacionais de um ano (inclui Carnaval, Sexta-feira Santa e Corpus Christi). |
| dias_uteisA | Quantidade de dias úteis entre duas datas (inclusive), descontando fins de semana e feriados nacionais. Não considera feriados estaduais/municipais. |
| indicador_economicoB | Últimos valores de um indicador do Banco Central (SGS): selic_meta, selic, cdi, ipca, igpm, dolar ou euro. |
| listar_municipiosA | Lista os municípios de uma UF com o código IBGE de cada um. |
| consultar_dddC | UF e cidades atendidas por um DDD. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| resumo_macro | Pede ao modelo um resumo do cenário de juros, inflação e câmbio. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| catalogo_indicadores | Catálogo dos indicadores disponíveis e seus códigos no SGS do Banco Central. |
TDQS
Scored across 8 tools
Each tool targets a clearly distinct resource or operation: CEP, CNPJ, document validation, holidays, business days, economic indicators, municipalities, and DDD. The only closely related pair is feriados_nacionais and dias_uteis, but their descriptions make the boundary explicit.
All names use consistent snake_case Portuguese and are readable, but the convention is not uniformly verb-first: consultar_cep, consultar_cnpj, validar_documento, and listar_municipios use verbs while feriados_nacionais, dias_uteis, indicador_economico, and consultar_ddd include noun-style names. This is a minor deviation rather than confusion.
Eight tools is well within the ideal 3–15 range and each tool covers a distinct Brazilian data utility. None appear redundant or trivial.
The set covers core Brazilian lookup and validation workflows well: CEP, CNPJ, CPF/CNPJ validation, holidays, business days, economic indicators, municipalities, and DDD. Minor gaps exist, such as no state list to support UF-based municipality lookup, no municipal/state holiday support beyond national holidays, and no reverse CEP/address geocoding.