Brasil

Brasil подключает AI-агентов к более чем 70 источникам данных бразильского правительства (533 инструмента, 15 тем). Обеспечивает эффективный доступ с локальным кешированием, перекрёстными ссылками, пакетным выполнением и интеллектуальным поиском данных.

Data Science и ML Веб-скрапинг и сбор данных Инструменты разработчика ★ 1,494 GitHub (1,494 ★)

mcp-brasil служит мощным MCP-сервером, предназначенным для бесшовной связи AI-агентов, таких как Claude, GPT и Copilot, с широким спектром публичных правительственных данных Бразилии. Он собирает информацию из 70 различных источников, охватывающих такие ключевые области, как экономика, законодательство, прозрачность, судебная система, выборы, окружающая среда, здравоохранение и другие. Этот инструмент упрощает доступ к сложным государственным наборам данных, позволяя AI-агентам обрабатывать запросы на естественном языке, перекрестно ссылаться на информацию и эффективно выполнять пакетные операции, с оптимизированной производительностью благодаря локальному кэшированию больших наборов данных и функциям интеллектуального обнаружения.

Ключевые особенности

01Интеллектуальное обнаружение с использованием BM25 search transform для фильтрации и рекомендации наиболее релевантных инструментов на основе контекста.

021,494 звезды на GitHub

03Возможности перекрестных ссылок с помощью `planejar_consulta` для объединения данных из нескольких API для сложных запросов.

04Пакетное выполнение для параллельных запросов через `executar_lote`, повышающее эффективность при множественных запросах данных.

05Оптимизированная обработка больших наборов данных с локальным кэшированием через встроенную DuckDB для таких функций, как данные TSE о выборах и цены на топливо ANP.

06Обширная коллекция из 533 инструментов по 70 функциям, охватывающая 15 тематических областей бразильских публичных данных.

Примеры использования

01Запрос законодательных данных по конкретным темам, отслеживание законопроектов и идентификация авторов из Палаты депутатов Бразилии и Федерального сената.

02Анализ экономических тенденций путем сравнения финансовых показателей, таких как ставка Selic и инфляция (IPCA), за определенные периоды.

03Исследуйте прозрачность федерального правительства, выявляя крупные контракты, расходы и поставщиков с официальных порталов.

mcp-brasil

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-brasil NÃ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.

Features

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

Quick Start

Instalar

pip install mcp-brasil

uv add mcp-brasil

Claude Desktop

Adicione 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.

VS Code / Cursor

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 Code

claude mcp add mcp-brasil -- uvx --from mcp-brasil python -m mcp_brasil.server

HTTP (outros clientes)

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

Exemplos

Conecte 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?"

Fontes de dados

Economia e Finanças

Feature	Fonte	Tools
`bacen`	Banco Central — Selic, IPCA, câmbio, PIB e +190 séries temporais (SGS)	9
`bcb_olinda`	Banco Central — PTAX (câmbio oficial), Expectativas Focus, taxas de juros bancárias	8
`bndes`	BNDES — operações de financiamento, desembolsos, instituições credenciadas	4
`ipeadata`	IPEADATA/Ipea — séries macro, regionais e sociais históricas (OData)	5

Geografia e Estatística

Feature	Fonte	Tools
`ibge`	IBGE — estados, municípios, nomes, agregados estatísticos	9

Legislativo e Executivo

Feature	Fonte	Tools
`camara`	Câmara dos Deputados — deputados, proposições, votações, despesas	11
`senado`	Senado Federal — senadores, matérias, votações, comissões	26
`governadores`	Governadores de todos os estados em exercício (nome, partido, mandato)	4

Transparência e Fiscalização

Feature	Fonte	Tools
`transparencia`	Portal da Transparência — contratos, despesas, servidores, sanções, imóveis funcionais, renúncias fiscais, órgãos, COVID-19	54
`tcu`	Tribunal de Contas da União — acórdãos, inidôneos, débitos, pautas	9
`tce_sp`	TCE-SP — despesas e receitas de 645 municípios paulistas	3
`tce_rj`	TCE-RJ — licitações, contratos, obras, penalidades, concessões	7
`tce_rs`	TCE-RS — educação, saúde, gestão fiscal (LRF)	5
`tce_pe`	TCE-PE — licitações, contratos, despesas, fornecedores	5
`tce_ce`	TCE-CE — licitações, contratos, empenhos	4
`tce_es`	TCE-ES — licitações, contratos, obras públicas	4
`tce_rn`	TCE-RN — jurisdicionados, licitações, contratos	5
`tce_pi`	TCE-PI — prefeituras, despesas, receitas	5
`tce_sc`	TCE-SC — municípios e unidades gestoras	2
`tce_to`	TCE-TO — processos, pautas de sessões	3
`tce_pa`	TCE-PA — Diário Oficial, sessões plenárias, jurisprudência (acórdãos, resoluções, portarias, prejulgados) e conteúdo informativo	4
`spu_geo`	SPU GeoPortal — terrenos de marinha, acrescidos, marginais, ilhas federais, praias, manguezais e localização de imóveis da União	4
`spu_imoveis`	Imóveis da União (Raio-X APF / Gov360) — busca por órgão, UF, município, regime e agregações institucionais	4
`siconfi`	SICONFI/Tesouro Nacional — RREO, RGF, DCA e MSC de municípios/estados (LRF, LC 101)	7
`mj`	MJSP (CKAN) — SINESP, INFOPEN, PROCONs/Sindec, armas, sistema prisional	4

Judiciário

Feature	Fonte	Tools
`datajud`	DataJud/CNJ — processos judiciais, movimentações	7
`jurisprudencia`	STF, STJ e TST — acórdãos, súmulas, decisões	6

Eleitoral

Feature	Fonte	Tools
`tse`	TSE — eleições, candidatos, prestação de contas	15
`anuncios_eleitorais`	Biblioteca de Anúncios da Meta — propaganda eleitoral na internet	6

Meio Ambiente

Feature	Fonte	Tools
`inpe`	INPE — focos de queimadas, desmatamento DETER/PRODES	4
`ana`	ANA — estações hidrológicas, telemetria, reservatórios	3
`ibama`	IBAMA (CKAN) — autos de infração, CTF/APP, TCFA, biomas	4

Energia e Infraestrutura

Feature	Fonte	Tools
`aneel`	ANEEL (CKAN) — SIGA, geração distribuída, tarifas, bandeiras	4
`antt`	ANTT (CKAN) — rodovias concedidas, acidentes, cargas, passageiros	4

Aviação

Feature	Fonte	Tools
`opensky`	OpenSky Network — voos ao vivo via ADS-B (rastreamento, tracks)	6

Saúde

Feature	Fonte	Tools
`saude`	CNES/DataSUS — estabelecimentos, profissionais, leitos	10
`opendatasus`	OpenDataSUS — datasets de saúde pública (CKAN)	7
`anvisa`	ANVISA — bulário, medicamentos, preços CMED, registros	10
`denasus`	DENASUS — auditorias do SUS	5
`imunizacao`	SI-PNI — vacinação, calendário, cobertura vacinal, SRAG	10
`bps`	BPS — preços de medicamentos e dispositivos médicos no SUS	3
`farmacia_popular`	Farmácia Popular — medicamentos gratuitos, farmácias credenciadas	8
`rename`	RENAME — medicamentos essenciais do SUS por princípio ativo	5

Segurança Pública

Feature	Fonte	Tools
`atlas_violencia`	Atlas da Violência (IPEA/FBSP) — homicídios, violência por gênero/raça, armas de fogo	7
`sinesp`	SINESP/MJSP — datasets de segurança pública, sistema penitenciário	6
`forum_seguranca`	Fórum Brasileiro de Segurança Pública — publicações, Anuário	4

Educação

Feature	Fonte	Tools
`inep`	INEP — índices educacionais (IDEB, indicadores) e pesquisas	4
`fnde`	FNDE — repasses, merenda escolar, PNATE, transporte	4

Compras Públicas

Feature	Fonte	Tools
`compras`	PNCP + ComprasNet/SIASG — licitações, contratos, pregões, CATMAT	29
`transferegov`	TransfereGov — emendas parlamentares PIX	5

Mercado Financeiro e Notícias

Feature	Fonte	Tools
`b3`	Bolsa B3 (brapi.dev) — cotações ações/FIIs/BDRs, históricos, índices	6
`noticias`	RSS agregado — Câmara, Senado, Agência Brasil, BCB	4

Dados Abertos e Utilidades

Feature	Fonte	Tools
`brasilapi`	BrasilAPI — CEP, CNPJ, DDD, bancos, câmbio, FIPE, PIX	16
`dados_abertos`	Dados Abertos (dados.gov.br) — catálogo de datasets federais	4
`diario_oficial`	Querido Diário + DOU — diários oficiais de 5.000+ cidades e da União	11
`tabua_mares`	Tábua de Marés — previsão de marés para portos do litoral	7

Datasets locais (opt-in via env)

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_siapa`	SPU — imóveis da União (SIAPA completo, 813k imóveis com dominiais + uso especial)	2026 snapshot	8
`tse_candidatos`	TSE — candidatos de todas as eleições (~4M registros)	2014-2024	8
`tse_bens`	TSE — bens declarados por candidatos, join via `sq_candidato`	2014-2024	5
`tse_votacao`	TSE — votos por candidato × município × zona	2014-2024	6
`tse_redes_sociais`	TSE — URLs Instagram/Facebook/Twitter dos candidatos	2018-2024	4
`tse_fefc`	TSE — Fundo Eleitoral Especial (distribuição partido × gênero)	2020, 2024	4
`anp_precos`	ANP — preços semanais de combustíveis (gasolina/etanol, diesel/GNV, GLP) em postos	2024 integral	7
`inep_censo_escolar`	INEP — Censo Escolar da Educação Básica (~180k escolas, infraestrutura, matrículas)	2023	7
`inep_enem`	INEP — Microdados ENEM (~3,9M inscritos, notas, perfil socioeconômico)	2023	6
`isp_rj`	ISP-RJ — estatísticas criminais mensais por CISP do Rio de Janeiro	1991-present	6
`anac_rab`	ANAC — Registro Aeronáutico Brasileiro (~75k aeronaves civis)	snapshot semanal	6
`anac_vra`	ANAC — Voos Regulares Ativos (pontualidade, atrasos, origem/destino)	2020-present	—
`cvm_fundos`	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_votacao

Ver 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_lote e listar_datasets_disponiveis.

Chaves de API

API	Obrigatória?	Como obter
Portal da Transparência	Opcional	Cadastro gratuito
DataJud/CNJ	Opcional	Cadastro gratuito
Anúncios Eleitorais (Meta)	Opcional	Meta Ad Library API
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-token

Configuração

Variável	Default	Descrição
`TRANSPARENCIA_API_KEY`	—	Chave do Portal da Transparência
`DATAJUD_API_KEY`	—	Chave do DataJud/CNJ
`META_ACCESS_TOKEN`	—	Token da Meta Ad Library API
`MCP_BRASIL_TOOL_SEARCH`	`bm25`	Modo de discovery: `bm25`, `code_mode` ou `none`
`MCP_BRASIL_HTTP_TIMEOUT`	`30.0`	Timeout HTTP em segundos
`MCP_BRASIL_HTTP_MAX_RETRIES`	`3`	Máximo de retentativas HTTP
`MCP_BRASIL_DATASETS`	—	Lista CSV de datasets locais a ativar. Ex: `tse_candidatos,tse_bens`
`MCP_BRASIL_DATASET_CACHE_DIR`	`~/.cache/mcp-brasil`	Diretório raiz do cache DuckDB
`MCP_BRASIL_DATASET_REFRESH`	`auto`	`auto` (TTL), `never` (só cache) ou `force` (sempre baixar)
`MCP_BRASIL_DATASET_TIMEOUT`	`600`	Timeout (s) do download de datasets grandes
`MCP_BRASIL_LGPD_ALLOW_PII`	—	Lista CSV de datasets com PII liberada (ex: `tse_candidatos`)

Documentação

Página	Descrição
Quick Start	Instalação e configuração em 2 minutos
Arquitetura	Como o projeto funciona por dentro
Catálogo de Features	Todas as 69 features e 525 tools
Datasets locais (DuckDB)	SIAPA + TSE 2014-2024 via SQL embedded
Smart Tools	Meta-tools: planner, batch, discovery
Adicionando Features	Guia para contribuir com novas APIs
Configuração	Variáveis de ambiente e opções
Meta Ad Library API	Referência da API de anúncios eleitorais da Meta
Code Mode	Discovery programático + sandbox Python (experimental)
Desenvolvimento	Setup de dev, testes, lint, CI
Deploy Azure (datasets)	Container Apps + Azure Files + warmup automático dos datasets

Desenvolvimento

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/prompts

Arquitetura

O 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.

Contribuindo

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

Disclaimer

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.

Não-oficialidade

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.

Conformidade legal

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

Licença

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

Star History

MCP-Brasil — MCP-сервер для 70+ источников открытых данных Бразилии

MCP-Brasil — это MCP-сервер, который предоставляет AI-агентам (Claude, GPT, Copilot и др.) доступ к более чем 70 публичным источникам данных Бразилии. Сервер включает 533 инструмента (tools), 131 ресурс (resources) и 102 промпта (prompts), охватывающих 15 тематических областей: экономика, законодательство, прокуратура, судебная система, выборы, экология, здравоохранение, образование, общественная безопасность, государственные закупки, финансы, авиация и другие.

⚠️ Важно: MCP-Brasil — это независимый проект. Он не является официальным сервисом правительства Бразилии или каких-либо учреждений, чьи данные он предоставляет. Код распространяется под лицензией MIT, но каждый источник данных имеет свою собственную лицензию (см. SOURCES.md). Перед коммерческим или журналистским использованием обязательно ознакомьтесь с Политикой допустимого использования.

66 API не требуют ключей, 4 используют бесплатные ключи (регистрация занимает 1 минуту).

Возможности

533 инструмента в 70 функциях, покрывающих 15 областей.
Большие наборы данных с локальным кешем — SIAPA (~813 тыс. объектов недвижимости), TSE 2014–2024 (кандидаты, имущество, голосование, соцсети, FEFC), ANP (цены на топливо), INEP (школьная перепись и ENEM), ISP-RJ (статистика преступности), ANAC (самолеты и рейсы). Данные хранятся в DuckDB (встраиваемая БД), активация через переменную окружения.
Перекрестные запросы с planejar_consulta — создание планов выполнения, объединяющих несколько API (например, расходы депутата + голосования + законопроекты).
Пакетное выполнение с executar_lote — запуск нескольких запросов параллельно в одном вызове.
Умный поиск — BM25-фильтрация 533 инструментов, показывающая только релевантные контексту.
Авторегистрация — добавление новой функции сводится к созданию папки; ручная настройка не требуется.
Асинхронность — httpx async + Pydantic v2 + ограничение скорости с backoff.

Быстрый старт

Установка

pip install mcp-brasil
# или
uv add mcp-brasil

Настройка для Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": ["--from", "mcp-brasil", "python", "-m", "mcp_brasil.server"],
      "env": {
        "TRANSPARENCIA_API_KEY": "ваш-ключ",
        "DATAJUD_API_KEY": "ваш-ключ",
        "META_ACCESS_TOKEN": "ваш-токен"
      }
    }
  }
}

Ключи опциональны — без них остальные 36 API работают как обычно.

Настройка для VS Code / Cursor

Создайте .vscode/mcp.json в корне проекта:

{
  "servers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": ["--from", "mcp-brasil", "python", "-m", "mcp_brasil.server"],
      "env": {
        "TRANSPARENCIA_API_KEY": "ваш-ключ",
        "DATAJUD_API_KEY": "ваш-ключ",
        "META_ACCESS_TOKEN": "ваш-токен"
      }
    }
  }
}

Настройка для Claude Code

claude mcp add mcp-brasil -- uvx --from mcp-brasil python -m mcp_brasil.server

HTTP (для других клиентов)

fastmcp run mcp_brasil.server:mcp --transport http --port 8000
# Сервер доступен по адресу http://localhost:8000/mcp

Примеры запросов

Подключите сервер и задавайте вопросы на естественном языке:

Законодательство: «Какие законопроекты об искусственном интеллекте рассматривались в Палате депутатов в 2024 году? Кто авторы?»
Экономика: «Какова динамика ставки Selic за последние 12 месяцев? Сравните с инфляцией (IPCA) за тот же период.»
Прозрачность: «Какие 10 крупнейших контрактов федерального правительства в 2024 году? Кто поставщики?»
Перекрестный запрос: «Сравните подушевые расходы на здравоохранение в Сан-Паулу и Минас-Жерайс, используя данные TCE-SP и IBGE.»
Судебная система: «Найдите процессы о нарушениях в госзакупках в TCU. Какие были наказания?»
Выборы: «Кто крупнейшие спонсоры кампании кандидата X? Какова общая сумма сборов?»

Источники данных

Экономика и финансы

bacen — Центральный банк: Selic, IPCA, курсы валют, ВВП и более 190 временных рядов (SGS) — 9 инструментов.
bcb_olinda — Центральный банк: PTAX (официальный курс), ожидания Focus, банковские процентные ставки — 8 инструментов.
bndes — BNDES: операции финансирования, выплаты, аккредитованные учреждения — 4 инструмента.
ipeadata — IPEADATA/Ipea: макроэкономические, региональные и социальные ряды (OData) — 5 инструментов.

География и статистика

ibge — IBGE: штаты, муниципалитеты, имена, статистические агрегаты — 9 инструментов.

Законодательная и исполнительная власть

camara — Палата депутатов: депутаты, законопроекты, голосования, расходы — 11 инструментов.
senado — Федеральный сенат: сенаторы, материалы, голосования, комиссии — 26 инструментов.
governadores — Действующие губернаторы всех штатов (имя, партия, срок) — 4 инструмента.

Прозрачность и контроль

transparencia — Портал прозрачности: контракты, расходы, госслужащие, санкции, недвижимость, налоговые льготы, COVID-19 — 54 инструмента.
tcu — Счетная палата Союза: постановления, недобросовестные поставщики, долги, повестки — 9 инструментов.
tce_sp, tce_rj, tce_rs, tce_pe, tce_ce, tce_es, tce_rn, tce_pi, tce_sc, tce_to, tce_pa — Счетные палаты штатов: расходы, доходы, закупки, контракты, образование, здравоохранение — от 2 до 7 инструментов каждая.
spu_geo — SPU GeoPortal: земли побережья, острова, пляжи, мангровые заросли, федеральная недвижимость — 4 инструмента.
spu_imoveis — Федеральная недвижимость (Raio-X APF / Gov360): поиск по органу, штату, муниципалитету — 4 инструмента.
siconfi — SICONFI/Казначейство: RREO, RGF, DCA, MSC муниципалитетов/штатов (LRF, LC 101) — 7 инструментов.
mj — MJSP (CKAN): SINESP, INFOPEN, PROCONs/Sindec, оружие, тюремная система — 4 инструмента.

Судебная система

datajud — DataJud/CNJ: судебные процессы, движения — 7 инструментов.
jurisprudencia — STF, STJ и TST: постановления, прецеденты, решения — 6 инструментов.

Выборы

tse — TSE: выборы, кандидаты, финансирование кампаний — 15 инструментов.
anuncios_eleitorais — Библиотека объявлений Meta: предвыборная реклама в интернете — 6 инструментов.

Окружающая среда

inpe — INPE: очаги пожаров, вырубка лесов DETER/PRODES — 4 инструмента.
ana — ANA: гидрологические станции, телеметрия, водохранилища — 3 инструмента.
ibama — IBAMA (CKAN): штрафы, CTF/APP, TCFA, биомы — 4 инструмента.

Энергетика и инфраструктура

aneel — ANEEL (CKAN): SIGA, распределенная генерация, тарифы, флаги — 4 инструмента.
antt — ANTT (CKAN): концессионные дороги, аварии, грузы, пассажиры — 4 инструмента.

Авиация

opensky — OpenSky Network: живые рейсы через ADS-B (отслеживание, треки) — 6 инструментов.

Здравоохранение

saude — CNES/DataSUS: учреждения, специалисты, койки — 10 инструментов.
opendatasus — OpenDataSUS: наборы данных общественного здравоохранения (CKAN) — 7 инструментов.
anvisa — ANVISA: справочник лекарств, цены CMED, регистрации — 10 инструментов.
denasus — DENASUS: аудиты SUS — 5 инструментов.
imunizacao — SI-PNI: вакцинация, календарь, охват, SRAG — 10 инструментов.
bps — BPS: цены на лекарства и медицинские устройства в SUS — 3 инструмента.
farmacia_popular — Farmácia Popular: бесплатные лекарства, аптеки — 8 инструментов.
rename — RENAME: основные лекарства SUS по действующему веществу — 5 инструментов.

Общественная безопасность

atlas_violencia — Атлас насилия (IPEA/FBSP): убийства, насилие по полу/расе, огнестрельное оружие — 7 инструментов.
sinesp — SINESP/MJSP: наборы данных общественной безопасности, тюремная система — 6 инструментов.
forum_seguranca — Бразильский форум общественной безопасности: публикации, ежегодник — 4 инструмента.

Образование

inep — INEP: образовательные индексы (IDEB, показатели) и исследования — 4 инструмента.
fnde — FNDE: трансферты, школьное питание, PNATE, транспорт — 4 инструмента.

Государственные закупки

compras — PNCP + ComprasNet/SIASG: тендеры, контракты, аукционы, CATMAT — 29 инструментов.
transferegov — TransfereGov: поправки к бюджету PIX — 5 инструментов.

Финансовый рынок и новости

b3 — B3 (brapi.dev): котировки акций/FIIs/BDRs, история, индексы — 6 инструментов.
noticias — RSS-агрегатор: Câmara, Senado, Agência Brasil, BCB — 4 инструмента.

Открытые данные и утилиты

brasilapi — BrasilAPI: CEP, CNPJ, DDD, банки, курсы валют, FIPE, PIX — 16 инструментов.
dados_abertos — Dados Abertos (dados.gov.br): каталог федеральных наборов данных — 4 инструмента.
diario_oficial — Querido Diário + DOU: официальные газеты 5000+ городов и Союза — 11 инструментов.
tabua_mares — Tábua de Marés: прогноз приливов для портов побережья — 7 инструментов.

Локальные наборы данных (opt-in через env)

Эти функции загружают большие CSV/ZIP-файлы (~100 МБ–1,6 ГБ) в локальную DuckDB и предоставляют SQL через готовые инструменты. Активируются только при указании в MCP_BRASIL_DATASETS. Первая загрузка занимает минуты (скачивание + импорт), последующие — миллисекунды.

spu_siapa — SPU: недвижимость Союза (SIAPA, 813 тыс. объектов) — 8 инструментов.
tse_candidatos — TSE: кандидаты всех выборов (~4 млн записей) — 8 инструментов.
tse_bens — TSE: задекларированное имущество кандидатов — 5 инструментов.
tse_votacao — TSE: голоса по кандидату × муниципалитет × зона — 6 инструментов.
tse_redes_sociais — TSE: URL Instagram/Facebook/Twitter кандидатов — 4 инструмента.
tse_fefc — TSE: Специальный избирательный фонд (распределение по партиям и полу) — 4 инструмента.
anp_precos — ANP: еженедельные цены на топливо на заправках — 7 инструментов.
inep_censo_escolar — INEP: школьная перепись (~180 тыс. школ) — 7 инструментов.
inep_enem — INEP: микроданные ENEM (~3,9 млн участников) — 6 инструментов.
isp_rj — ISP-RJ: ежемесячная статистика преступности по районам Рио-де-Жанейро — 6 инструментов.
anac_rab — ANAC: бразильский реестр воздушных судов (~75 тыс. гражданских самолетов) — 6 инструментов.
anac_vra — ANAC: активные регулярные рейсы (пунктуальность, задержки) — инструменты не указаны.
cvm_fundos — CVM: реестр инвестиционных фондов (~40 тыс. фондов) — 6 инструментов.

Активация:

# .env
MCP_BRASIL_DATASETS=tse_candidatos,tse_bens,tse_votacao

Подробнее: Руководство по локальным наборам данных.

Корневой сервер также предоставляет 5 мета-инструментов: listar_features, recomendar_tools, planejar_consulta, executar_lote и listar_datasets_disponiveis.

Ключи API

API	Обязательно?	Как получить
Portal da Transparência	Опционально	[Бесплатная регистрация](https://portaldatransparencia.gov.br/api-de-dados/cadast

Источник: https://mcpmarket.com/server/brasil-2