mcp-brasil
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DATAJUD_API_KEY | No | Chave do DataJud/CNJ | |
| META_ACCESS_TOKEN | No | Token da Meta Graph API para anúncios eleitorais | |
| OPENSANCTIONS_API_KEY | No | Chave da API OpenSanctions | |
| TRANSPARENCIA_API_KEY | No | Chave do Portal da Transparência | |
| MCP_BRASIL_TOOL_SEARCH | No | Modo de discovery: bm25, code_mode ou none | bm25 |
| MCP_BRASIL_HTTP_TIMEOUT | No | Timeout HTTP em segundos | 30.0 |
| MCP_BRASIL_HTTP_MAX_RETRIES | No | Máximo de retentativas HTTP | 3 |
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": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| listar_featuresA | Lista todas as features (APIs) disponíveis no mcp-brasil. Use esta tool para saber quais APIs governamentais estão conectadas e quais tools cada uma oferece. Returns: Resumo das features ativas com descrição e status de autenticação. |
| recomendar_toolsA | Recomenda tools relevantes a partir de uma pergunta em linguagem natural. Usa IA para entender sua intenção e sugerir as tools mais adequadas do mcp-brasil, explicando quando e como usar cada uma. Args: query: Pergunta ou descrição do que você precisa (ex: "quero dados sobre gastos do governo federal"). |
| planejar_consultaA | Cria um plano de execução para consultas complexas. Analisa a pergunta, identifica quais tools usar, em que ordem, e quais etapas dependem de outras. Útil para consultas que precisam de múltiplas chamadas combinadas. Args: query: Pergunta em linguagem natural (ex: "compare os gastos do deputado X com a média"). |
| executar_loteA | Executa múltiplas tools em uma única chamada, em paralelo. Use esta tool para evitar chamadas sequenciais quando precisar de dados de várias fontes ou de vários anos/parâmetros ao mesmo tempo. Cada consulta deve ter o nome completo da tool (com namespace, ex: "camara_buscar_proposicao") e seus argumentos. Args: consultas: Lista de consultas. Cada item é um objeto com: - "tool": nome completo da tool (ex: "camara_despesas_deputado") - "args": objeto com os argumentos da tool Exemplo: [ {"tool": "camara_despesas_deputado", "args": {"deputado_id": 204554, "ano": 2024}}, {"tool": "camara_despesas_deputado", "args": {"deputado_id": 204554, "ano": 2023}} ] |
| search_toolsA | Search for tools using natural language. Returns matching tool definitions ranked by relevance, in the same format as list_tools. |
| call_toolA | Call a tool by name with the given arguments. Use this to execute tools discovered via search_tools. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| ana_analise_bacia | Gera uma análise hidrológica completa de uma bacia hidrográfica. Cria um template de análise que orienta o LLM a consultar estações, dados telemétricos e reservatórios de uma bacia hidrográfica brasileira. Args: bacia: Nome ou código da bacia hidrográfica (ex: "Paraná", "São Francisco"). |
| anuncios_eleitorais_analise_candidato | Análise completa dos anúncios eleitorais de um candidato ou partido. Gera uma análise detalhada dos gastos, alcance e estratégia de anúncios eleitorais na Biblioteca de Anúncios da Meta. Args: nome_candidato: Nome do candidato ou partido para analisar. pagina_id: ID da página do Facebook (opcional, melhora precisão). |
| anuncios_eleitorais_panorama_eleitoral | Panorama dos anúncios eleitorais em um estado ou no Brasil. Gera uma visão geral dos anúncios políticos veiculados, incluindo maiores anunciantes e temas predominantes. Args: estado: Nome do estado para filtrar (ex: 'São Paulo'). Vazio = Brasil todo. periodo_inicio: Data de início no formato YYYY-mm-dd (opcional). periodo_fim: Data de fim no formato YYYY-mm-dd (opcional). |
| anuncios_eleitorais_comparar_candidatos | Comparação de estratégia de anúncios entre dois candidatos ou partidos. Analisa diferenças em gastos, alcance, público-alvo e mensagens. Args: candidato_a: Nome do primeiro candidato ou partido. candidato_b: Nome do segundo candidato ou partido. |
| bacen_analise_economica | Gera um panorama da conjuntura econômica brasileira. Cria um template que orienta o LLM a consultar os principais indicadores econômicos e produzir uma análise integrada. Args: periodo: Período de análise (ex: "últimos 12 meses", "2024", "jan/2024 a dez/2024"). |
| bacen_comparar_indicadores | Compara séries temporais específicas do BCB. Cria um template de análise comparativa entre indicadores selecionados. Args: codigos: Códigos das séries separados por vírgula (ex: "432,433,3698"). periodo: Período de análise. |
| brasilapi_analise_empresa | Análise completa de uma empresa brasileira pelo CNPJ. Gera um relatório com dados cadastrais, endereço e situação. Args: cnpj: CNPJ da empresa (com ou sem formatação). |
| brasilapi_panorama_economico | Panorama das principais taxas e indicadores econômicos. |
| camara_acompanhar_proposicao | Gera um acompanhamento completo de uma proposição legislativa. Cria um template que orienta o LLM a consultar dados da proposição, tramitação e votações na Câmara dos Deputados. Args: sigla_tipo: Tipo da proposição (ex: PL, PEC, MPV). numero: Número da proposição. ano: Ano da proposição. |
| camara_perfil_deputado | Gera um perfil completo de um deputado federal. Cria um template com dados pessoais, votações e despesas do deputado. Args: deputado_id: ID do deputado na API da Câmara. |
| camara_analise_votacao | Gera uma análise detalhada de uma votação na Câmara. Cria um template que analisa os votos nominais por partido e região. Args: votacao_id: ID da votação na API da Câmara. |
| compras_pncp_investigar_fornecedor | Investiga um fornecedor em contratações públicas. Args: cnpj: CNPJ do fornecedor a investigar. |
| dados_abertos_explorar_dados | Explora dados abertos sobre um tema específico. Args: tema: Tema de interesse (ex: saúde, educação, meio ambiente). |
| dadosabertos_mt_explorar_tema_mt | Exploração de datasets de um tema no Portal Dados Abertos MT. Descobre e analisa todos os datasets disponíveis sobre um tema no catálogo do governo de Mato Grosso. Args: tema: Tema de interesse (ex: "saúde", "educação", "segurança", "meio ambiente"). |
| datajud_analise_processo | Gera uma análise completa de um processo judicial. Orienta o LLM a consultar dados do processo, partes e movimentações. Args: numero_processo: Número do processo (NPU). tribunal: Sigla do tribunal (ex: tjsp, trf1, stj). |
| datajud_pesquisa_juridica | Gera uma pesquisa jurídica sobre um tema. Orienta o LLM a buscar processos relacionados a um tema específico. Args: tema: Tema jurídico para pesquisar. tribunal: Sigla do tribunal. Default: tjsp. |
| diario_oficial_investigar_empresa | Investiga menções de uma empresa em diários oficiais municipais. Args: nome_empresa: Nome da empresa ou CNPJ para investigar. cidade: Nome da cidade para filtrar (opcional). |
| ibge_resumo_estado | Gera um resumo analítico completo de um estado brasileiro. Cria um template de análise que orienta o LLM a consultar dados de população, PIB, municípios e indicadores geográficos do estado. Args: uf: Sigla do estado com 2 letras (ex: SP, RJ, PI, BA). |
| ibge_comparativo_regional | Gera uma comparação entre as 5 macro-regiões do Brasil. Cria um template que orienta o LLM a comparar indicadores de população, PIB e desenvolvimento entre Norte, Nordeste, Sudeste, Sul e Centro-Oeste. |
| inpe_monitoramento_ambiental | Gera uma análise de monitoramento ambiental de uma região. Cria um template que orienta o LLM a consultar dados de queimadas, desmatamento e alertas DETER para uma região específica. Args: regiao: Nome da região ou bioma a analisar (ex: Amazônia, Cerrado, PA). |
| iomat_mt_monitorar_orgao_mt | Monitoramento de publicações de um órgão no Diário Oficial MT. Busca e analisa todas as publicações recentes de um órgão público no Diário Oficial do Estado de Mato Grosso. Args: orgao: Nome do órgão, secretaria ou entidade (ex: "Secretaria de Saúde", "Prefeitura de Cuiabá"). |
| iomat_mt_investigar_licitacao_mt | Investigação de licitações publicadas no Diário Oficial MT. Busca e analisa publicações de licitações, pregões e dispensas no Diário Oficial do Estado de Mato Grosso. Args: termo: Termo de busca (empresa, objeto, número de pregão, CNPJ, etc.). |
| jurisprudencia_pesquisa_jurisprudencial | Gera uma pesquisa jurisprudencial completa sobre um tema. Orienta o LLM a buscar decisões em múltiplos tribunais superiores. Args: tema: Tema jurídico para pesquisar. tribunais: Tribunais para consultar (separados por vírgula). Default: stf,stj,tst. |
| jurisprudencia_analise_tema | Gera uma análise de um tema de repercussão geral do STF. Args: numero_tema: Número do tema de repercussão geral. |
| redator_redator_oficio | Redator de Ofício — comunicação oficial (padrão ofício, 3ª edição). Na 3ª edição do Manual de Redação (2018), memorando e aviso foram ABOLIDOS. O ofício é agora o ÚNICO tipo de comunicação oficial, usado tanto para comunicação interna quanto externa. Args: destinatario: Nome do destinatário. cargo_destinatario: Cargo (ex: "Secretário de Fazenda"). assunto: Tema do ofício. orgao_remetente: Órgão que envia (opcional). |
| redator_redator_despacho | Redator de Despacho — decisão administrativa sobre processo ou requerimento. Use este prompt para redigir despachos que aprovam, indeferem, encaminham ou determinam providências sobre processos administrativos. Args: assunto: O que o despacho deve decidir/encaminhar. contexto: Informações adicionais (número do processo, setor, etc.). |
| redator_redator_portaria | Redator de Portaria — ato normativo de autoridade administrativa. Use este prompt para redigir portarias que nomeiam, designam, regulamentam ou determinam providências administrativas. Args: assunto: O que a portaria determina. autoridade: Autoridade que assina (ex: "Secretário de Administração"). fundamentacao: Base legal (ex: "Lei nº 8.112/1990, art. 67"). |
| redator_redator_parecer | Redator de Parecer — manifestação técnica ou jurídica sobre consulta. Use este prompt para redigir pareceres técnicos, jurídicos ou administrativos em resposta a consultas formais. Args: processo: Número do processo ou referência. consulta: Pergunta ou tema a ser analisado. area: Área do parecer: "jurídico", "técnico", "contábil" (default: jurídico). |
| redator_redator_nota_tecnica | Redator de Nota Técnica — análise técnica com dados e evidências. Use este prompt para redigir notas técnicas que fundamentam decisões com dados, análises e recomendações. Pode consultar dados em tempo real do IBGE, Bacen e Portal da Transparência. Args: assunto: Tema da nota técnica. dados: Dados ou fontes a serem consultadas (opcional). |
| saude_analise_rede_saude | Gera uma análise da rede de saúde de um município. Cria um template de análise que orienta o LLM a consultar dados de estabelecimentos, profissionais e leitos hospitalares do município. Args: codigo_municipio: Código IBGE do município (ex: "355030" para São Paulo). |
| senado_acompanhar_materia | Gera um acompanhamento completo de uma matéria legislativa no Senado. Cria um template que orienta o LLM a consultar dados da matéria, tramitação e votações no Senado Federal. Args: sigla_tipo: Tipo da matéria (ex: PEC, PLS, PLC, MPV). numero: Número da matéria. ano: Ano da matéria. |
| senado_perfil_senador | Gera um perfil completo de um senador. Cria um template com dados pessoais e votações do senador. Args: codigo: Código do senador na API do Senado. |
| senado_analise_votacao_senado | Gera uma análise detalhada de uma votação no Senado. Cria um template que analisa o resultado e contexto de uma votação. Args: codigo_sessao: Código da sessão de votação. |
| tabua_mares_consulta_mares | Consulta completa de marés para um estado e mês. Guia o LLM a buscar portos e tábua de marés para planejar atividades costeiras como pesca, navegação ou surfe. Args: estado: Sigla do estado costeiro (ex: rj, sp, pb). mes: Mês para consulta (1-12). |
| tabua_mares_analise_navegacao | Análise de condições de maré para navegação em uma localização. Guia o LLM a encontrar o porto mais próximo e analisar as condições de maré para navegação segura. Args: lat: Latitude da localização. lng: Longitude da localização. estado: Sigla do estado costeiro. |
| tce_ce_analisar_municipio_ce | Análise de um município cearense no TCE-CE. Cruza licitações, contratos e empenhos para avaliar a gestão de compras e despesas do município. Args: codigo_municipio: Código do município (ex: "057"). ano: Ano de referência (ex: 2024). |
| tce_pe_analisar_municipio_pe | Análise de um município pernambucano no TCE-PE. Cruza licitações, contratos e despesas para avaliar a gestão de compras e despesas do município. Args: municipio: Nome do município (ex: "Recife"). ano: Ano de referência (ex: 2024). |
| tce_pi_analisar_municipio_pi | Prompt para análise fiscal de um município do Piauí. Args: municipio: Nome do município a ser analisado. exercicio: Ano do exercício fiscal. |
| tce_rj_analisar_municipio_rj | Análise completa de um município fluminense no TCE-RJ. Verifica licitações, contratos, compras diretas, obras paralisadas, penalidades e prestação de contas de um município do Rio de Janeiro. Args: municipio: Nome do município em MAIÚSCULAS (ex: "NITEROI"). |
| tce_rn_analisar_unidade_rn | Análise orçamentária e de licitações de uma unidade do RN. Gera uma análise completa usando dados de despesas, receitas, licitações e contratos do TCE-RN. Args: id_unidade: ID da unidade (obtido via listar_jurisdicionados_rn). ano: Ano de referência (padrão: 2024). |
| tce_rs_analisar_municipio_rs | Análise fiscal e de compliance de um município do RS. Gera uma análise completa usando dados de educação, saúde e gestão fiscal do TCE-RS para verificar o cumprimento de obrigações legais. Args: municipio: Nome do município (ex: "Porto Alegre"). ano: Ano de referência (padrão: 2024). |
| tce_sc_consultar_unidades_sc | Consulta das unidades gestoras de um município de SC. Lista todas as unidades gestoras (prefeitura, câmara, autarquias, consórcios) de um município catarinense. Args: municipio: Nome do município (ex: "Florianópolis"). |
| tce_sp_analisar_financas_municipio_sp | Análise financeira de um município paulista no TCE-SP. Cruza despesas e receitas mensais para avaliar a saúde financeira. Args: municipio: Slug do município (ex: "campinas"). exercicio: Ano fiscal (ex: 2025). |
| tce_to_analisar_pessoa_to | Análise de processos de uma pessoa no TCE-TO. Busca e analisa todos os processos vinculados a uma pessoa no Tribunal de Contas do Tocantins. Args: nome: Nome da pessoa a pesquisar. |
| tcu_investigar_empresa_tcu | Investigação completa de empresa nos cadastros do TCU. Verifica a situação de uma empresa em todos os cadastros de sanções do TCU, incluindo inidoneidade, certidões consolidadas e contratos com o tribunal. Args: cnpj: CNPJ da empresa (somente números, 14 dígitos). |
| transferegov_analise_emendas_pix | Analisa emendas pix (transferências especiais) de um ano. Cria um template que orienta o LLM a consultar e analisar emendas parlamentares do tipo transferência especial. Args: ano: Ano de exercício a analisar (ex: 2024). uf: UF para filtrar análise (opcional, ex: PI, SP). |
| transparencia_auditoria_fornecedor | Gera uma auditoria completa de um fornecedor do governo federal. Cria um template que orienta o LLM a consultar contratos, sanções e emendas relacionados a um fornecedor específico por CPF ou CNPJ. Args: cpf_cnpj: CPF ou CNPJ do fornecedor (ex: 12345678000190). |
| transparencia_analise_despesas | Gera uma análise de despesas do governo federal em um período. Cria um template que orienta o LLM a consultar e analisar despesas públicas, emendas e licitações em um período. Args: mes_ano_inicio: Mês/ano de início no formato MM/AAAA (ex: 01/2024). mes_ano_fim: Mês/ano de fim no formato MM/AAAA (ex: 12/2024). uf: UF para filtrar análise (opcional, ex: PI, SP). |
| transparencia_verificacao_compliance | Verifica a situação de uma empresa ou pessoa nas bases de sanções federais. Cria um template de due diligence/compliance que consulta todas as bases de sanções (CEIS, CNEP, CEPIM, CEAF) simultaneamente. Args: consulta: CPF, CNPJ ou nome da pessoa/empresa a verificar. |
| tse_analise_candidato | Gera uma análise completa de um candidato. Orienta o LLM a consultar dados do candidato, patrimônio e prestação de contas. Args: nome: Nome do candidato para buscar. ano: Ano da eleição. municipio: Código do município. eleicao_id: ID da eleição. cargo: Código do cargo. |
| tse_comparativo_eleicao | Gera um comparativo entre candidatos de uma eleição. Args: ano: Ano da eleição. municipio: Código do município. eleicao_id: ID da eleição. cargo: Código do cargo. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| tipos_estacao | Tipos de estações hidrológicas da ANA (fluviométrica e pluviométrica). |
| estados_brasileiros | Lista dos 27 estados brasileiros (sigla e nome) para filtros regionais. |
| parametros_busca | Referência dos parâmetros de busca disponíveis na API de anúncios eleitorais. |
| campos_disponiveis | Referência dos campos de dados disponíveis nos resultados de anúncios eleitorais. |
| catalogo_series | Catálogo completo das 193 séries temporais do BCB disponíveis. |
| categorias_series | As 12 categorias de séries temporais do BCB com contagem de séries. |
| indicadores_chave | Os 5 indicadores econômicos principais: Selic, IPCA, IPCA 12m, Dólar PTAX, IBC-Br. |
| taxas_disponiveis | Catálogo de taxas e índices oficiais disponíveis para consulta. |
| tipos_veiculo_fipe | Tipos de veículo aceitos nas consultas FIPE. |
| endpoints_brasilapi | Catálogo de todos os endpoints disponíveis na BrasilAPI. |
| tipos_proposicao | Tipos de proposição legislativa da Câmara dos Deputados. |
| legislaturas_recentes | Legislaturas recentes da Câmara dos Deputados. |
| info_api | Informações gerais sobre a API da Câmara dos Deputados. |
| modalidades_licitacao | Catálogo de modalidades de licitação conforme Lei 14.133/2021. |
| formatos_disponiveis | Formatos de arquivo comuns no Portal Dados Abertos. |
| endpoints_disponiveis | Endpoints disponíveis na API CKAN do Portal Dados Abertos MT. |
| tribunais_disponiveis | Lista de tribunais disponíveis na API DataJud com siglas e nomes. |
| classes_processuais | Classes processuais comuns para busca no DataJud. |
| info_api | Informações gerais sobre a API DataJud (CNJ). |
| capitais_cobertas | Capitais brasileiras com cobertura confirmada no Querido Diário. |
| estados_brasileiros | Lista dos 27 estados brasileiros com sigla, nome e região. |
| regioes_brasileiras | As 5 macro-regiões do Brasil com quantidade de estados. |
| niveis_territoriais | Referência dos níveis territoriais do IBGE e seus códigos de API. |
| biomas_brasileiros | Lista dos 6 biomas brasileiros monitorados pelo INPE. |
| estados_amazonia_legal | Lista dos 9 estados da Amazônia Legal. |
| endpoints_disponiveis | Endpoints disponíveis na API IOMAT do Diário Oficial de Mato Grosso. |
| diarios_disponiveis | Diários disponíveis na API IOMAT de Mato Grosso. |
| tribunais_superiores | Informações sobre os tribunais superiores (STF, STJ, TST). |
| operadores_busca | Operadores de busca disponíveis por tribunal para pesquisa jurisprudencial. |
| info_api | Informações gerais sobre as APIs de jurisprudência. |
| get_template_oficio | Template oficial para Ofício (padrão ofício — 3ª edição). |
| get_template_despacho | Template oficial para Despacho administrativo. |
| get_template_portaria | Template oficial para Portaria. |
| get_template_parecer | Template oficial para Parecer técnico. |
| get_template_nota_tecnica | Template oficial para Nota Técnica. |
| get_template_ata | Template oficial para Ata de reunião. |
| get_manual_redacao | Resumo das normas do Manual de Redação da Presidência da República (3ª ed.). |
| get_pronomes_tratamento | Tabela de pronomes de tratamento oficiais. |
| get_fechos_oficiais | Fechos e saudações para correspondência oficial. |
| codigos_uf_cnes | Códigos IBGE de UF usados para filtrar dados no CNES/DataSUS. |
| tipos_materia | Tipos de matéria legislativa do Senado Federal com siglas e descrições. |
| info_api | Informações gerais sobre a API de Dados Abertos do Senado. |
| comissoes_permanentes | Comissões permanentes do Senado Federal. |
| estados_costeiros | Lista dos 17 estados costeiros do Brasil com dados de marés disponíveis. |
| endpoints_tce_ce | Endpoints disponíveis na API de Dados Abertos do TCE-CE (SIM). Lista os principais módulos com parâmetros obrigatórios. |
| endpoints_tce_pe | Endpoints disponíveis na API de Dados Abertos do TCE-PE. Lista os principais módulos com parâmetros típicos. |
| endpoints_tce_pi | Return a JSON description of all TCE-PI endpoints. |
| endpoints_disponiveis | Endpoints disponíveis na API de Dados Abertos do TCE-RJ. Lista os módulos de dados abertos com descrição e filtros disponíveis. |
| endpoints_tce_rn | Catálogo de endpoints disponíveis no TCE-RN. |
| endpoints_tce_rs | Catálogo de endpoints e dados disponíveis no portal TCE-RS. |
| endpoints_tce_sc | Catálogo de endpoints disponíveis no TCE-SC. |
| endpoints_tce_sp | Endpoints disponíveis na API de Transparência do TCE-SP. Descreve os 3 endpoints JSON com parâmetros e formato de dados. |
| endpoints_tce_to | Catálogo de endpoints disponíveis no TCE-TO. |
| tipos_certidoes_apf | Tipos de certidões consolidadas disponíveis no sistema APF do TCU. O sistema APF (Administração Pública Federal) consulta 4 cadastros de sanções simultaneamente para verificar a situação de uma empresa. |
| info_api | Informações sobre a API do TransfereGov e como usar. |
| endpoints_disponiveis | Lista de todos os endpoints da API do Portal da Transparência disponíveis. |
| bases_sancoes | As 4 bases de sanções federais com descrição e parâmetros de consulta. |
| info_api | Informações gerais sobre a API do Portal da Transparência. |
| categorias_beneficios | Lista de tipos de benefícios sociais disponíveis para consulta. |
| cargos_eleitorais | Códigos de cargos eleitorais do TSE. |
| info_api | Informações gerais sobre a API do TSE (DivulgaCandContas). |
TDQS
Scored across 6 tools
Several tools overlap in discovery and planning: recomendar_tools, planejar_consulta, and search_tools all take natural-language queries and return tool suggestions, while listar_features also enumerates available tools. They differ in output format, but an agent may struggle to pick the right one.
All names follow a verb_noun snake_case pattern, but the language is inconsistent: four Portuguese names and two English names, with recomendar_tools mixing Portuguese and English within one name. This mixed-language naming reduces predictability.
Six tools is a reasonable number for a meta-orchestration server that wraps many underlying data APIs. Each tool has a distinct role and the count falls comfortably within the well-scoped 3-15 range.
The tool surface covers discovery, search, recommendation, planning, batch execution, and single execution. A minor gap is the absence of an explicit full-tool-list command like standard list_tools, but agents can work around with listar_features and search_tools.