Integrates with the Brazilian PIX system to access data related to instant payments, bank information, and the tracking of parliamentary amendments (emendas PIX).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-brasil Quais projetos de lei sobre inteligência artificial tramitaram na Câmara em 2024?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Server para 70 fontes de dados públicas brasileiras
533 tools · 131 resources · 102 prompts · 70 features · 15 áreas temáticas
Conecte AI agents (Claude, GPT, Copilot, etc.) a dados governamentais do Brasil — economia, legislação, transparência, judiciário, eleições, meio ambiente, saúde, educação, segurança pública, fiscal subnacional, aviação e mais.
66 APIs não requerem chave · 4 usam chaves gratuitas (cadastro em 1 min)
Quick Start · Fontes de dados · Documentação · Desenvolvimento
⚠️ Projeto independente.
mcp-brasilNÃO é serviço oficial do governo brasileiro nem de qualquer das instituições cujos dados ele torna acessíveis. A licença MIT cobre apenas o código — cada fonte de dado tem sua própria licença (SOURCES.md) e o uso do servidor está sujeito à Política de Uso Aceitável. Antes de uso comercial, jornalístico ou decisório, leia ambos.
533 tools em 70 features cobrindo 15 áreas — economia, legislativo, transparência, judiciário, eleitoral, ambiental, saúde, educação, segurança pública, compras públicas, fiscal subnacional, aviação, energia e mais
Datasets grandes com cache local — SIAPA (~813k imóveis), TSE 2014-2024 (candidatos, bens, votação, redes sociais, FEFC), ANP preços de combustíveis, INEP Censo Escolar e ENEM, ISP-RJ segurança pública, ANAC aeronaves e voos regulares — SQL via DuckDB embedded, opt-in via env
Cross-referencing com planejar_consulta — cria planos de execução combinando múltiplas APIs (ex: gastos de um deputado + votações + proposições)
Execução em lote com executar_lote — dispara consultas em paralelo numa única chamada
Smart discovery — BM25 search transform filtra 533 tools para só mostrar as relevantes ao contexto
Auto-registry — adicionar uma feature é criar uma pasta; zero configuração manual
Async everywhere — httpx async + Pydantic v2 + rate limiting com backoff
Related MCP server: mcp-brasil
pip install mcp-brasiluv add mcp-brasilAdicione ao claude_desktop_config.json:
{
"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"
}
}
}
}As chaves são opcionais — sem elas, as 36 APIs restantes funcionam normalmente.
Crie .vscode/mcp.json na raiz do projeto:
{
"servers": {
"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"
}
}
}
}claude mcp add mcp-brasil -- uvx --from mcp-brasil python -m mcp_brasil.serverfastmcp run mcp_brasil.server:mcp --transport http --port 8000
# Server disponível em http://localhost:8000/mcpConecte o server e faça perguntas em linguagem natural:
Legislativo: "Quais projetos de lei sobre inteligência artificial tramitaram na Câmara em 2024? Quem foram os autores?"
Econômico: "Qual a tendência da taxa Selic nos últimos 12 meses? Compare com a inflação (IPCA) no mesmo período."
Transparência: "Quais os 10 maiores contratos do governo federal em 2024? Quem são os fornecedores?"
Cross-reference: "Compare os gastos per capita com saúde em São Paulo e Minas Gerais cruzando dados do TCE-SP e IBGE."
Judiciário: "Busque processos sobre licitação irregular no TCU. Quais foram as penalidades aplicadas?"
Eleitoral: "Quais os maiores doadores da campanha do candidato X? Qual o total arrecadado?"
Feature | Fonte | Tools |
| Banco Central — Selic, IPCA, câmbio, PIB e +190 séries temporais (SGS) | 9 |
| Banco Central — PTAX (câmbio oficial), Expectativas Focus, taxas de juros bancárias | 8 |
| BNDES — operações de financiamento, desembolsos, instituições credenciadas | 4 |
| IPEADATA/Ipea — séries macro, regionais e sociais históricas (OData) | 5 |
Feature | Fonte | Tools |
| IBGE — estados, municípios, nomes, agregados estatísticos | 9 |
Feature | Fonte | Tools |
| Câmara dos Deputados — deputados, proposições, votações, despesas | 11 |
| Senado Federal — senadores, matérias, votações, comissões | 26 |
| Governadores de todos os estados em exercício (nome, partido, mandato) | 4 |
Feature | Fonte | Tools |
| Portal da Transparência — contratos, despesas, servidores, sanções, imóveis funcionais, renúncias fiscais, órgãos, COVID-19 | 54 |
| Tribunal de Contas da União — acórdãos, inidôneos, débitos, pautas | 9 |
| TCE-SP — despesas e receitas de 645 municípios paulistas | 3 |
| TCE-RJ — licitações, contratos, obras, penalidades, concessões | 7 |
| TCE-RS — educação, saúde, gestão fiscal (LRF) | 5 |
| TCE-PE — licitações, contratos, despesas, fornecedores | 5 |
| TCE-CE — licitações, contratos, empenhos | 4 |
| TCE-ES — licitações, contratos, obras públicas | 4 |
| TCE-RN — jurisdicionados, licitações, contratos | 5 |
| TCE-PI — prefeituras, despesas, receitas | 5 |
| TCE-SC — municípios e unidades gestoras | 2 |
| TCE-TO — processos, pautas de sessões | 3 |
| TCE-PA — Diário Oficial, sessões plenárias, jurisprudência (acórdãos, resoluções, portarias, prejulgados) e conteúdo informativo | 4 |
| SPU GeoPortal — terrenos de marinha, acrescidos, marginais, ilhas federais, praias, manguezais e localização de imóveis da União | 4 |
| Imóveis da União (Raio-X APF / Gov360) — busca por órgão, UF, município, regime e agregações institucionais | 4 |
| SICONFI/Tesouro Nacional — RREO, RGF, DCA e MSC de municípios/estados (LRF, LC 101) | 7 |
| MJSP (CKAN) — SINESP, INFOPEN, PROCONs/Sindec, armas, sistema prisional | 4 |
Feature | Fonte | Tools |
| DataJud/CNJ — processos judiciais, movimentações | 7 |
| STF, STJ e TST — acórdãos, súmulas, decisões | 6 |
Feature | Fonte | Tools |
| TSE — eleições, candidatos, prestação de contas | 15 |
| Biblioteca de Anúncios da Meta — propaganda eleitoral na internet | 6 |
Feature | Fonte | Tools |
| INPE — focos de queimadas, desmatamento DETER/PRODES | 4 |
| ANA — estações hidrológicas, telemetria, reservatórios | 3 |
| IBAMA (CKAN) — autos de infração, CTF/APP, TCFA, biomas | 4 |
Feature | Fonte | Tools |
| ANEEL (CKAN) — SIGA, geração distribuída, tarifas, bandeiras | 4 |
| ANTT (CKAN) — rodovias concedidas, acidentes, cargas, passageiros | 4 |
Feature | Fonte | Tools |
| OpenSky Network — voos ao vivo via ADS-B (rastreamento, tracks) | 6 |
Feature | Fonte | Tools |
| CNES/DataSUS — estabelecimentos, profissionais, leitos | 10 |
| OpenDataSUS — datasets de saúde pública (CKAN) | 7 |
| ANVISA — bulário, medicamentos, preços CMED, registros | 10 |
| DENASUS — auditorias do SUS | 5 |
| SI-PNI — vacinação, calendário, cobertura vacinal, SRAG | 10 |
| BPS — preços de medicamentos e dispositivos médicos no SUS | 3 |
| Farmácia Popular — medicamentos gratuitos, farmácias credenciadas | 8 |
| RENAME — medicamentos essenciais do SUS por princípio ativo | 5 |
Feature | Fonte | Tools |
| Atlas da Violência (IPEA/FBSP) — homicídios, violência por gênero/raça, armas de fogo | 7 |
| SINESP/MJSP — datasets de segurança pública, sistema penitenciário | 6 |
| Fórum Brasileiro de Segurança Pública — publicações, Anuário | 4 |
Feature | Fonte | Tools |
| INEP — índices educacionais (IDEB, indicadores) e pesquisas | 4 |
| FNDE — repasses, merenda escolar, PNATE, transporte | 4 |
Feature | Fonte | Tools |
| PNCP + ComprasNet/SIASG — licitações, contratos, pregões, CATMAT | 29 |
| TransfereGov — emendas parlamentares PIX | 5 |
Feature | Fonte | Tools |
| Bolsa B3 (brapi.dev) — cotações ações/FIIs/BDRs, históricos, índices | 6 |
| RSS agregado — Câmara, Senado, Agência Brasil, BCB | 4 |
Feature | Fonte | Tools |
| BrasilAPI — CEP, CNPJ, DDD, bancos, câmbio, FIPE, PIX | 16 |
| Dados Abertos (dados.gov.br) — catálogo de datasets federais | 4 |
| Querido Diário + DOU — diários oficiais de 5.000+ cidades e da União | 11 |
| Tábua de Marés — previsão de marés para portos do litoral | 7 |
Features que baixam CSVs/ZIPs grandes (~100MB–1,6GB) para DuckDB embedded local
e expõem SQL via tools canned. Ativadas apenas quando listadas em MCP_BRASIL_DATASETS.
Primeira carga: minutos (download + ingest); subsequentes: ms.
Feature | Fonte | Período | Tools |
| SPU — imóveis da União (SIAPA completo, 813k imóveis com dominiais + uso especial) | 2026 snapshot | 8 |
| TSE — candidatos de todas as eleições (~4M registros) | 2014-2024 | 8 |
| TSE — bens declarados por candidatos, join via | 2014-2024 | 5 |
| TSE — votos por candidato × município × zona | 2014-2024 | 6 |
| TSE — URLs Instagram/Facebook/Twitter dos candidatos | 2018-2024 | 4 |
| TSE — Fundo Eleitoral Especial (distribuição partido × gênero) | 2020, 2024 | 4 |
| ANP — preços semanais de combustíveis (gasolina/etanol, diesel/GNV, GLP) em postos | 2024 integral | 7 |
| INEP — Censo Escolar da Educação Básica (~180k escolas, infraestrutura, matrículas) | 2023 | 7 |
| INEP — Microdados ENEM (~3,9M inscritos, notas, perfil socioeconômico) | 2023 | 6 |
| ISP-RJ — estatísticas criminais mensais por CISP do Rio de Janeiro | 1991-present | 6 |
| ANAC — Registro Aeronáutico Brasileiro (~75k aeronaves civis) | snapshot semanal | 6 |
| ANAC — Voos Regulares Ativos (pontualidade, atrasos, origem/destino) | 2020-present | — |
| CVM — Cadastro de Fundos de Investimento (~40k fundos, PL, taxa adm, gestor) | snapshot diário | 6 |
Ative com:
# .env
MCP_BRASIL_DATASETS=tse_candidatos,tse_bens,tse_votacaoVer guia de Datasets locais para detalhes de uso.
O server raiz também expõe 5 meta-tools:
listar_features,recomendar_tools,planejar_consulta,executar_loteelistar_datasets_disponiveis.
API | Obrigatória? | Como obter |
Portal da Transparência | Opcional | |
DataJud/CNJ | Opcional | |
Anúncios Eleitorais (Meta) | Opcional | |
brapi.dev (B3) | Opcional | Token gratuito para índices e múltiplas ações |
Todas as outras (62) | Nenhuma chave | — |
Configure via variáveis de ambiente ou .env:
TRANSPARENCIA_API_KEY=sua-chave
DATAJUD_API_KEY=sua-chave
META_ACCESS_TOKEN=seu-tokenVariável | Default | Descrição |
| — | Chave do Portal da Transparência |
| — | Chave do DataJud/CNJ |
| — | Token da Meta Ad Library API |
|
| Modo de discovery: |
|
| Timeout HTTP em segundos |
|
| Máximo de retentativas HTTP |
| — | Lista CSV de datasets locais a ativar. Ex: |
|
| Diretório raiz do cache DuckDB |
|
|
|
|
| Timeout (s) do download de datasets grandes |
| — | Lista CSV de datasets com PII liberada (ex: |
Página | Descrição |
Instalação e configuração em 2 minutos | |
Como o projeto funciona por dentro | |
Todas as 69 features e 525 tools | |
SIAPA + TSE 2014-2024 via SQL embedded | |
Meta-tools: planner, batch, discovery | |
Guia para contribuir com novas APIs | |
Variáveis de ambiente e opções | |
Referência da API de anúncios eleitorais da Meta | |
Discovery programático + sandbox Python (experimental) | |
Setup de dev, testes, lint, CI | |
Container Apps + Azure Files + warmup automático dos datasets |
git clone https://github.com/Mcp-Brasil/mcp-brasil.git
cd mcp-brasil
make dev # Instalar dependências (prod + dev)
make test # Rodar todos os testes
make test-feature F=ibge # Testes de uma feature
make lint # Lint + format check
make ruff # Auto-fix lint + format
make types # mypy strict
make ci # lint + types + test
make run # Server stdio
make serve # Server HTTP :8000
make inspect # Listar tools/resources/promptsO projeto usa Package by Feature com Auto-Registry — cada feature é uma pasta auto-contida:
src/mcp_brasil/
├── server.py # Auto-registry (nunca editado manualmente)
├── _shared/ # Utilitários compartilhados
│ └── datasets/ # Infra DuckDB local
├── data/ # 51 features — REST passthrough
│ ├── ibge/
│ │ ├── __init__.py # FEATURE_META
│ │ ├── server.py # FastMCP instance
│ │ ├── tools.py # Lógica das tools
│ │ ├── client.py # HTTP async
│ │ ├── schemas.py # Pydantic models
│ │ └── constants.py # URLs, códigos
│ ├── bacen/
│ └── ...
├── datasets/ # 12 features — cache local DuckDB (opt-in via env)
│ ├── spu_siapa/ # SIAPA 813k imóveis
│ ├── tse_candidatos/ # TSE candidatos 2014-2024
│ └── ...
└── agentes/ # 1 feature — agentes inteligentes
└── redator/Três modalidades de feature coexistem:
data/ — REST passthrough: HTTP async → Pydantic → tool formatada
datasets/ — DuckDB embedded local: CSVs/ZIPs grandes com SQL,
gated por MCP_BRASIL_DATASETS, cache em ~/.cache/mcp-brasil/
agentes/ — Agentes inteligentes: tools + prompts + resources
compondo fluxos complexos (ex: redação oficial)
Para adicionar uma nova feature, basta criar o diretório seguindo a convenção — o registry descobre automaticamente.
Fork o repositório
Crie uma feature em src/mcp_brasil/data/{feature}/ ou agentes/{feature}/
Exporte FEATURE_META no __init__.py e mcp: FastMCP no server.py
Adicione testes em tests/data/{feature}/
Rode make ci e abra um PR
Este projeto integra um número significativo de APIs governamentais brasileiras, muitas com documentação inconsistente ou incompleta. Embora todo esforço tenha sido feito para garantir precisão, alguns endpoints podem retornar resultados inesperados ou ter cobertura parcial de parâmetros.
Este é um projeto open-source da comunidade — se encontrar algo quebrado ou que possa ser melhorado, abra uma issue ou envie um PR. O objetivo é tornar dados públicos brasileiros acessíveis via IA, juntos.
Todos os dados vêm de APIs oficiais do governo brasileiro — o server não gera, modifica ou editorializa nenhum dado. No entanto, modelos de IA que consomem este servidor podem alucinar, distorcer ou interpretar incorretamente respostas — VERIFIQUE NA FONTE OFICIAL antes de uso jornalístico, judicial, médico ou decisório.
mcp-brasil é projeto independente. NÃO é serviço, programa ou parceria do Governo Federal, Ministérios, Agências, Tribunais ou de qualquer das instituições cujos dados acessa. Tampouco é endossado por Anthropic, OpenAI, GitHub, ou pelos modelos de IA clientes. A palavra "Brasil" no nome refere-se ao objeto (dados públicos brasileiros) e não a vinculação institucional.
Antes de operar este servidor — especialmente em cenários comerciais, com volume, em período eleitoral, ou envolvendo dados sensíveis (saúde, judicial, eleitoral) — leia obrigatoriamente:
SOURCES.md — licença e disclaimer de cada uma das 70 fontes
ACCEPTABLE_USE.md — Política de Uso Aceitável (vedações sob LGPD art. 11 §4, Lei 9.504/97, Res. CNJ 446/2022, etc.)
NOTICE — escopo da licença MIT e atribuições
Código deste repositório: MIT
Dados retornados pelas APIs: licenças variadas — ver SOURCES.md
Uso do servidor: sujeito à Política de Uso Aceitável
Atribuições e disclaimers: NOTICE
Call a tool by name with the given arguments.
Use this to execute tools discovered via search_tools.
Inputs: name (required), arguments.
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}} ]
Inputs: consultas (required). Returns: result
Lista os datasets locais (ADR-004) disponíveis e seu estado de cache.
Features em datasets/ dependem de cache local em DuckDB e só aparecem
quando listadas em MCP_BRASIL_DATASETS. Esta tool reporta todos
os datasets registrados no projeto (ativos e inativos), com tamanho
aproximado, fonte, e se o cache local já foi baixado.
Returns: Tabela markdown com id, habilitado, cached, linhas, tamanho, fonte.
Inputs: no named parameters. Returns: result
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.
Inputs: no named parameters. Returns: result
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").
Inputs: query (required). Returns: result
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").
Inputs: query (required). Returns: result
Search for tools using natural language.
Returns matching tool definitions ranked by relevance, in the same format as list_tools.
Inputs: query (required). Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 7 tools
There is noticeable overlap between recomendar_tools, planejar_consulta, and search_tools, as all accept natural language queries and return tool recommendations, albeit in different formats. listar_features and listar_datasets_disponiveis are distinct but share a similar prefix. The remaining tools are clearly separated.
Tool names mix Portuguese (listar, recomendar, planejar, executar) and English (search, call), creating an inconsistent impression. Although most follow a verb_noun pattern, the language switch is jarring and not predictable.
Seven tools is well-scoped for a meta-orchestration server. Each tool serves a distinct role in the discovery, planning, and execution workflow without unnecessary redundancy or excessive count.
The tool set covers the main workflow: listing features, discovering tools, planning queries, and executing them individually or in batch. Minor gaps exist, such as no direct tool to manage datasets or inspect feature details, but the core surface is functional.
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.
MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).
Hosted MCP server for live public-data APIs and Skills for AI agents.
