brasil-mcp-essentials
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
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
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| validate_cpfA | Valida CPF brasileiro (11 dígitos). Módulo 11. Rejeita sequências repetidas. |
| validate_cnpjA | Valida CNPJ brasileiro — legacy (14 dígitos) E novo alfanumérico (Receita Federal NT COCAD/SUARA 49/2024). Auto-detecta. |
| validate_pisB | Valida PIS/PASEP/NIT (11 dígitos). |
| validate_renavamC | Valida RENAVAM (11 dígitos). |
| validate_cnhB | Valida CNH brasileira (11 dígitos). |
| validate_titulo_eleitorB | Valida título de eleitor (12 dígitos). |
| validate_credit_cardB | Valida cartão de crédito (Luhn) e detecta bandeira: Visa, Mastercard, Elo, Hipercard, Amex, Diners, JCB, Discover. |
| parse_boletoA | Parse boleto bancário (47 linha digitável / 44 código de barras) OU arrecadação (48). Detecta tipo automaticamente. |
| parse_pix_brcodeA | Parse BR Code PIX (string EMV). Retorna chave, beneficiário, valor, txid, descrição. |
| generate_pix_brcodeC | Gera BR Code PIX estático. qr_format: 'none' | 'png' | 'svg' | 'both'. |
| is_feriado_nacionalA | Verifica se uma data (YYYY-MM-DD) é feriado brasileiro. UF opcional para estaduais. |
| proximo_dia_utilA | Retorna o próximo dia útil após uma data. Pula fins de semana e feriados. |
| contar_dias_uteisB | Conta dias úteis entre duas datas (inclui início, exclui fim por padrão). |
| listar_feriadosA | Lista feriados brasileiros num ano. UF opcional para incluir estaduais. |
| lookup_cepA | Consulta endereço de CEP brasileiro via ViaCEP (online). Retorna logradouro, bairro, cidade, UF, IBGE code, DDD. Resultado cacheado localmente por 30 dias. |
| lookup_banco_febrabanA | Consulta banco brasileiro por código FEBRABAN (3 dígitos) via BrasilAPI (online). Cobre 200+ bancos. Cacheado 7 dias. |
| lookup_dddA | Consulta UF e lista de municípios por código DDD (2 dígitos) via BrasilAPI (online). Cacheado 90 dias. |
| lookup_ibge_municipioA | Consulta código IBGE de município brasileiro por nome (acento-insensível). UF opcional. Cacheado 30 dias. |
| lookup_cotacao_brlA | Consulta cotação PTAX BRL via Banco Central. Moedas: USD, EUR, GBP, JPY, ARS, CHF, CAD, AUD. data_cotacao opcional (default hoje). Cacheado 1h pra recente, 1 ano pra histórico. |
| lookup_endereco_cepA | Busca lista de CEPs por endereço (UF + cidade + logradouro) via ViaCEP (online). Aceita match parcial no logradouro. Cacheado 30 dias. |
| validate_telefoneA | Valida e formata telefone brasileiro (celular 11 dígitos ou fixo 10). Aceita com/sem +55, qualquer máscara. Retorna formatted, formatted_international, e164, ddd, tipo (celular/fixo). |
| generate_whatsapp_qrA | Gera link wa.me (deeplink WhatsApp) + QR opcional pra telefone brasileiro. mensagem opcional (URL-encoded). qr_format: 'none' | 'png' | 'svg' | 'both'. |
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 22 tools
All 22 tools target distinct concepts: each validation covers a specific Brazilian document (CPF, CNPJ, PIS, RENAVAM, CNH, título de eleitor, credit card); parsing and generation tools for boleto/PIX are unique; date utilities handle holidays and business days; lookup tools address different data sources (CEP, banks, DDD, IBGE, currency, address). No two tools overlap in purpose.
Most tools follow a verb_noun pattern, but language is mixed: 'validate_cpf', 'parse_boleto', 'generate_pix_brcode' use English verbs, while 'is_feriado_nacional', 'proximo_dia_util', 'listar_feriados' use Portuguese. 'lookup' verbs are English. This inconsistency in language could confuse an agent expecting a single language convention.
22 tools is on the higher end but appropriate for a 'brasil-essentials' server that covers validation, parsing, generation, date utilities, and multiple lookups. Each tool serves a clear need; no tool feels superfluous. However, the count could slightly overwhelm an agent if the domain is narrower.
The tool set is remarkably comprehensive for Brazilian administrative and financial tasks: includes validation for all major national documents, boleto and PIX payment processing, holiday/business day calculations, and lookups for CEP, banks, DDD, IBGE codes, currency rates, and address by logradouro. No obvious gaps for common needs.