Imagine poder perguntar a um agente de IA “Quais foram os 10 maiores contratos do governo federal em 2024?” ou “Qual a tendência da taxa Selic nos últimos 12 meses?” e receber respostas precisas baseadas em dados oficiais do governo brasileiro. Isso agora é possível com o MCP Brasil, um projeto open-source que conecta agentes de IA como Claude, GPT e GitHub Copilot a 41 APIs públicas brasileiras.

O que é MCP Brasil?

MCP Brasil é um MCP Server (Model Context Protocol) que oferece acesso estruturado a dados governamentais brasileiros através de 326 ferramentas, cobrindo 11 áreas temáticas:

• 📊 Economia e Finanças: Banco Central, BNDES
• 🏛️ Legislativo: Câmara dos Deputados, Senado Federal
• 💰 Transparência: Portal da Transparência, TCU, 10 TCEs estaduais
• ⚖️ Judiciário: DataJud/CNJ, STF, STJ, TST
• 🗳️ Eleitoral: TSE, Anúncios Eleitorais (Meta)
• 🌳 Meio Ambiente: INPE (queimadas/desmatamento), ANA
• 🏥 Saúde: DataSUS, ANVISA, CNES, vacinação, Farmácia Popular
• 🚨 Segurança Pública: Atlas da Violência, SINESP
• 🏢 Compras Públicas: PNCP, ComprasNet, TransfereGov
• 📍 Geografia: IBGE (estados, municípios, estatísticas)
• 🛠️ Utilidades: BrasilAPI (CEP, CNPJ, bancos), Diários Oficiais

O melhor? 38 das 41 APIs não requerem chaves de acesso. As três que requerem (Portal da Transparência, DataJud e Meta Ads) oferecem cadastro gratuito em menos de 1 minuto.

Testando na Prática

Vamos ver o MCP Brasil em ação. Realizei um teste simples: pedir informações sobre o CNPJ da Google Brasil.

Teste 1: Consulta de CNPJ

Pergunta: “Ache todas as informações sobre o CNPJ 06.990.590/0001-23”

O MCP Brasil automaticamente:

1. Consultou a BrasilAPI para dados cadastrais completos
2. Buscou no PNCP por contratações públicas
3. Verificou no TCU contratos e irregularidades federais
4. Procurou no DOU publicações oficiais relacionadas
5. Checou sanções e restrições administrativas

Resultado em segundos:

Em uma única consulta, o MCP Brasil agregou dados de 5 fontes oficiais diferentes de forma automática e estruturada - um trabalho que levaria horas para fazer manualmente visitando cada portal individualmente.

💊 Exemplo 2: Consulta ao Banco de Medicamentos

Vamos fazer uma consulta mais complexa.

Pergunta: “Quero saber sobre medicamentos de dipirona disponíveis no Brasil, comparar genéricos com o de referência, e verificar se estão disponíveis gratuitamente na Farmácia Popular”

O MCP Brasil acessa automaticamente 3 bases diferentes da área da saúde:

Neste segundo exemplo, o MCP Brasil cruzou 3 bases de dados diferentes:

• ANVISA (Bulário Eletrônico): Registros sanitários e categorias
• RENAME: Lista oficial de medicamentos essenciais do SUS
• Farmácia Popular: Disponibilidade gratuita e farmácias credenciadas

Essa capacidade de cruzar informações de múltiplas fontes especializadas torna análises complexas triviais.

Capacidades de Cross-Reference

O que torna o MCP Brasil especialmente poderoso é sua capacidade de planejamento de consultas com a ferramenta planejar_consulta. Ela analisa perguntas complexas e cria um plano de execução combinando múltiplas APIs.

Exemplos de perguntas que o MCP Brasil pode responder:

1. Legislativo + Transparência:
   “Quais deputados votaram a favor do Projeto de Lei X e quais suas despesas com gabinete em 2024?”

2. Economia + Comparativo:
   “Compare a taxa Selic com o IPCA nos últimos 24 meses”

3. Saúde + Geografia:
   “Quantos leitos de UTI existem por 100 mil habitantes em cada capital do Nordeste?”

4. Transparência + Eleitoral:
   “Quais empresas receberam mais contratos federais e qual seu histórico de doações eleitorais?”

5. Meio Ambiente + Temporal:
   “Mostre a evolução do desmatamento na Amazônia nos últimos 5 anos com dados do PRODES/INPE”

Arquitetura Inteligente

O MCP Brasil usa uma arquitetura Package by Feature com auto-registro. Cada API é uma feature auto-contida:

src/mcp_brasil/
├── data/
│   ├── ibge/           # 9 ferramentas
│   ├── bacen/          # 9 ferramentas  
│   ├── camara/         # 11 ferramentas
│   ├── anvisa/         # 10 ferramentas
│   └── ...             # 37 outras features
└── agentes/
    └── redator/        # Geração de documentos

Recursos avançados:

• Smart Discovery: BM25 search filtra automaticamente as 326 ferramentas para mostrar apenas as relevantes ao contexto
• Execução em Lote: executar_lote dispara consultas em paralelo numa única chamada
• Async Everywhere: httpx async + rate limiting com backoff exponencial
• Zero Config: adicionar uma feature é criar uma pasta - sem configuração manual

Como Usar

Instalação

1
2
3

pip install mcp-brasil
# ou
uv add mcp-brasil

Configuração no VS Code/Cursor

Crie .vscode/mcp.json na raiz do seu projeto:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

{
    "servers": {
        "mcp-brasil": {
            "command": "python",
            "args": ["-m", "mcp_brasil.server"],
            "env": {
                "TRANSPARENCIA_API_KEY": "sua-chave-aqui",
                "DATAJUD_API_KEY": "sua-chave-aqui",
                "META_ACCESS_TOKEN": "seu-token-aqui"
            }
        }
    }
}

Nota: As chaves são opcionais. Sem elas, 38 APIs continuam funcionando normalmente.

Configuração no Claude Desktop

Adicione ao claude_desktop_config.json:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

{
    "mcpServers": {
        "mcp-brasil": {
            "command": "uvx",
            "args": ["--from", "mcp-brasil", "python", "-m", "mcp_brasil.server"],
            "env": {
                "TRANSPARENCIA_API_KEY": "sua-chave-aqui",
                "DATAJUD_API_KEY": "sua-chave-aqui",
                "META_ACCESS_TOKEN": "seu-token-aqui"
            }
        }
    }
}

Modo HTTP (outros clientes)

1
2

fastmcp run mcp_brasil.server:mcp --transport http --port 8000
# Server disponível em http://localhost:8000/mcp

Casos de Uso Reais

1. Jornalismo de Dados

Cruzar dados do Portal da Transparência com prestação de contas do TSE para investigar relações entre contratos públicos e financiamento de campanhas.

2. Pesquisa Acadêmica

Analisar tendências de vacinação (SI-PNI) correlacionadas com dados socioeconômicos do IBGE.

3. Análise de Mercado

Acompanhar séries temporais do Banco Central (Selic, câmbio, PIB) para modelagem financeira.

4. Compliance e Due Diligence

Verificar automaticamente se fornecedores possuem sanções no TCU, CEIS ou estão em listas restritivas.

5. Monitoramento Legislativo

Acompanhar tramitação de projetos de lei específicos na Câmara e Senado com alertas automáticos.

6. Auditoria de Saúde Pública

Cruzar dados de estabelecimentos de saúde (CNES) com registros de medicamentos (ANVISA) e auditorias (DENASUS).

Performance e Limitações

Durante meus testes, o MCP Brasil demonstrou:

✅ Pontos Fortes:

• Respostas em segundos para consultas simples
• Excellent handling de rate limits com backoff automático
• Agregação inteligente de múltiplas fontes
• Fallback gracioso quando APIs estão indisponíveis

⚠️ Considerações:

• Algumas APIs governamentais têm documentação inconsistente
• Rate limits variam por API (geralmente 60-100 req/min)
• Dados podem ter atraso de atualização (varia por fonte)
• 3 APIs requerem cadastro gratuito (mas muito simples)

Conclusão

O MCP Brasil representa um avanço significativo na democratização do acesso a dados públicos brasileiros. Ao conectar agentes de IA a 41 APIs governamentais, ele transforma consultas complexas que levariam horas em respostas instantâneas.

Se você trabalha com análise de dados, jornalismo investigativo, pesquisa acadêmica, ou simplesmente quer explorar dados públicos brasileiros de forma mais eficiente, o MCP Brasil é uma ferramenta essencial.

O projeto está em constante evolução, e a comunidade open-source continua adicionando novas features. Vale muito a pena experimentar e, quem sabe, contribuir com novas integrações.

Links Úteis

• 📦 GitHub: github.com/jxnxts/mcp-brasil
• 📖 Documentação: Catálogo completo de features
• 🚀 Quick Start: Guia de instalação
• 🤝 Contribuindo: Guia de contribuição