Skip to content
Back to search

mcp-brasil

MCP Server para 70 APIs públicas brasileiras

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mcp-brasil--mcp-brasil/badge.svg)](/listings/mcp-brasil--mcp-brasil)

HTML

<a href="/listings/mcp-brasil--mcp-brasil"><img src="/api/listings/mcp-brasil--mcp-brasil/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Instalar

pip install mcp-brasil
uv add mcp-brasil

Google Antigravity

Adicione o bloco abaixo ao seu `mcp_config.json` — acessível em **MCP Servers → Manage MCP Servers → View raw config**, ou editando direto `~/.gemini/config/mcp_config.json` (global) / `.agents/mcp_config.json` (workspace):

{
  "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"
      }
    }
  }
}

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 454 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="docs/assets/logo.png" alt="mcp-brasil logo" width="100">
  3. # mcp-brasil
  4. **MCP Server para 70 fontes de dados públicas brasileiras**
  5. [![License: MIT (code)](https://img.shields.io/badge/code-MIT-yellow.svg)](LICENSE) [![Sources: see SOURCES.md](https://img.shields.io/badge/data-see%20SOURCES.md-blue)](SOURCES.md) [![AUP](https://img.shields.io/badge/use-ACCEPTABLE__USE.md-orange)](ACCEPTABLE_USE.md)
  6. 533 tools · 131 resources · 102 prompts · 70 features · 15 áreas temáticas
  7. 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.
  8. **66 APIs não requerem chave** · 4 usam chaves gratuitas (cadastro em 1 min)
  9. [Quick Start](#quick-start) · [Fontes de dados](#fontes-de-dados) · [Documentação](#documentação) · [Desenvolvimento](#desenvolvimento)
  10. </div>
  11. ---
  12. > ⚠️ **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](SOURCES.md)) e o uso do servidor está sujeito à [Política de Uso Aceitável](ACCEPTABLE_USE.md). Antes de uso comercial, jornalístico ou decisório, **leia ambos**.
  13. ---
  14. ## Features
  15. - **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
  16. - **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
  17. - **Cross-referencing** com `planejar_consulta` — cria planos de execução combinando múltiplas APIs (ex: gastos de um deputado + votações + proposições)
  18. - **Execução em lote** com `executar_lote` — dispara consultas em paralelo numa única chamada
  19. - **Smart discovery** — BM25 search transform filtra 533 tools para só mostrar as relevantes ao contexto
  20. - **Auto-registry** — adicionar uma feature é criar uma pasta; zero configuração manual
  21. - **Async everywhere** — httpx async + Pydantic v2 + rate limiting com backoff
  22. ## Quick Start
  23. ### Instalar
  24. ```bash
  25. pip install mcp-brasil
  26. ```
  27. ```bash
  28. uv add mcp-brasil
  29. ```
  30. ### Google Antigravity
  31. Adicione o bloco abaixo ao seu `mcp_config.json` — acessível em **MCP Servers → Manage MCP Servers → View raw config**, ou editando direto `~/.gemini/config/mcp_config.json` (global) / `.agents/mcp_config.json` (workspace):
  32. ```json
  33. {
  34. "mcpServers": {
  35. "mcp-brasil": {
  36. "command": "uvx",
  37. "args": ["--from", "mcp-brasil", "python", "-m", "mcp_brasil.server"],
  38. "env": {
  39. "TRANSPARENCIA_API_KEY": "sua-chave-aqui",
  40. "DATAJUD_API_KEY": "sua-chave-aqui",
  41. "META_ACCESS_TOKEN": "seu-token-aqui"
  42. }
  43. }
  44. }
  45. }
  46. ```
  47. ### Claude Desktop
  48. Adicione ao `claude_desktop_config.json`:
  49. ```json
  50. {
  51. "mcpServers": {
  52. "mcp-brasil": {
  53. "command": "uvx",
  54. "args": ["--from", "mcp-brasil", "python", "-m", "mcp_brasil.server"],
  55. "env": {
  56. "TRANSPARENCIA_API_KEY": "sua-chave-aqui",
  57. "DATAJUD_API_KEY": "sua-chave-aqui",
  58. "META_ACCESS_TOKEN": "seu-token-aqui"
  59. }
  60. }
  61. }
  62. }
  63. ```
  64. > As chaves são opcionais — sem elas, as 36 APIs restantes funcionam normalmente.
  65. ### VS Code / Cursor
  66. Crie `.vscode/mcp.json` na raiz do projeto:
  67. ```json
  68. {
  69. "servers": {
  70. "mcp-brasil": {
  71. "command": "uvx",
  72. "args": ["--from", "mcp-brasil", "python", "-m", "mcp_brasil.server"],
  73. "env": {
  74. "TRANSPARENCIA_API_KEY": "sua-chave-aqui",
  75. "DATAJUD_API_KEY": "sua-chave-aqui",
  76. "META_ACCESS_TOKEN": "seu-token-aqui"
  77. }
  78. }
  79. }
  80. }
  81. ```
  82. ### Claude Code
  83. ```bash
  84. claude mcp add mcp-brasil -- uvx --from mcp-brasil python -m mcp_brasil.server
  85. ```
  86. ### HTTP (outros clientes)
  87. ```bash
  88. fastmcp run mcp_brasil.server:mcp --transport http --port 8000
  89. # Server disponível em http://localhost:8000/mcp
  90. ```
  91. ## Exemplos
  92. Conecte o server e faça perguntas em linguagem natural:
  93. > **Legislativo:** "Quais projetos de lei sobre inteligência artificial tramitaram na Câmara em 2024? Quem foram os autores?"
  94. > **Econômico:** "Qual a tendência da taxa Selic nos últimos 12 meses? Compare com a inflação (IPCA) no mesmo período."
  95. > **Transparência:** "Quais os 10 maiores contratos do governo federal em 2024? Quem são os fornecedores?"
  96. > **Cross-reference:** "Compare os gastos per capita com saúde em São Paulo e Minas Gerais cruzando dados do TCE-SP e IBGE."
  97. > **Judiciário:** "Busque processos sobre licitação irregular no TCU. Quais foram as penalidades aplicadas?"
  98. > **Eleitoral:** "Quais os maiores doadores da campanha do candidato X? Qual o total arrecadado?"
  99. ## Fontes de dados
  100. ### Economia e Finanças
  101. | Feature | Fonte | Tools |
  102. |---------|-------|:-----:|
  103. | `bacen` | Banco Central — Selic, IPCA, câmbio, PIB e +190 séries temporais (SGS) | 9 |
  104. | `bcb_olinda` | Banco Central — PTAX (câmbio oficial), Expectativas Focus, taxas de juros bancárias | 8 |
  105. | `bndes` | BNDES — operações de financiamento, desembolsos, instituições credenciadas | 4 |
  106. | `ipeadata` | IPEADATA/Ipea — séries macro, regionais e sociais históricas (OData) | 5 |
  107. ### Geografia e Estatística
  108. | Feature | Fonte | Tools |
  109. |---------|-------|:-----:|
  110. | `ibge` | IBGE — estados, municípios, nomes, agregados estatísticos | 9 |
  111. ### Legislativo e Executivo
  112. | Feature | Fonte | Tools |
  113. |---------|-------|:-----:|
  114. | `camara` | Câmara dos Deputados — deputados, proposições, votações, despesas | 11 |
  115. | `senado` | Senado Federal — senadores, matérias, votações, comissões | 26 |
  116. | `governadores` | Governadores de todos os estados em exercício (nome, partido, mandato) | 4 |
  117. ### Transparência e Fiscalização
  118. | Feature | Fonte | Tools |
  119. |---------|-------|:-----:|
  120. | `transparencia` | Portal da Transparência — contratos, despesas, servidores, sanções, imóveis funcionais, renúncias fiscais, órgãos, COVID-19 | 54 |
  121. | `tcu` | Tribunal de Contas da União — acórdãos, inidôneos, débitos, pautas | 9 |
  122. | `tce_sp` | TCE-SP — despesas e receitas de 645 municípios paulistas | 3 |
  123. | `tce_rj` | TCE-RJ — licitações, contratos, obras, penalidades, concessões | 7 |
  124. | `tce_rs` | TCE-RS — educação, saúde, gestão fiscal (LRF) | 5 |
  125. | `tce_pe` | TCE-PE — licitações, contratos, despesas, fornecedores | 5 |
  126. | `tce_ce` | TCE-CE — licitações, contratos, empenhos | 4 |
  127. | `tce_es` | TCE-ES — licitações, contratos, obras públicas | 4 |
  128. | `tce_rn` | TCE-RN — jurisdicionados, licitações, contratos | 5 |
  129. | `tce_pi` | TCE-PI — prefeituras, despesas, receitas | 5 |
  130. | `tce_sc` | TCE-SC — municípios e unidades gestoras | 2 |
  131. | `tce_to` | TCE-TO — processos, pautas de sessões | 3 |
  132. | `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 |
  133. | `spu_geo` | SPU GeoPortal — terrenos de marinha, acrescidos, marginais, ilhas federais, praias, manguezais e localização de imóveis da União | 4 |
  134. | `spu_imoveis` | Imóveis da União (Raio-X APF / Gov360) — busca por órgão, UF, município, regime e agregações institucionais | 4 |
  135. | `siconfi` | SICONFI/Tesouro Nacional — RREO, RGF, DCA e MSC de municípios/estados (LRF, LC 101) | 7 |
  136. | `mj` | MJSP (CKAN) — SINESP, INFOPEN, PROCONs/Sindec, armas, sistema prisional | 4 |
  137. ### Judiciário
  138. | Feature | Fonte | Tools |
  139. |---------|-------|:-----:|
  140. | `datajud` | DataJud/CNJ — processos judiciais, movimentações | 7 |
  141. | `jurisprudencia` | STF, STJ e TST — acórdãos, súmulas, decisões | 6 |
  142. ### Eleitoral
  143. | Feature | Fonte | Tools |
  144. |---------|-------|:-----:|
  145. | `tse` | TSE — eleições, candidatos, prestação de contas | 15 |
  146. | `anuncios_eleitorais` | Biblioteca de Anúncios da Meta — propaganda eleitoral na internet | 6 |
  147. ### Meio Ambiente
  148. | Feature | Fonte | Tools |
  149. |---------|-------|:-----:|
  150. | `inpe` | INPE — focos de queimadas, desmatamento DETER/PRODES | 4 |
  151. | `ana` | ANA — estações hidrológicas, telemetria, reservatórios | 3 |
  152. | `ibama` | IBAMA (CKAN) — autos de infração, CTF/APP, TCFA, biomas | 4 |
  153. ### Energia e Infraestrutura
  154. | Feature | Fonte | Tools |
  155. |---------|-------|:-----:|
  156. | `aneel` | ANEEL (CKAN) — SIGA, geração distribuída, tarifas, bandeiras | 4 |
  157. | `antt` | ANTT (CKAN) — rodovias concedidas, acidentes, cargas, passageiros | 4 |
  158. ### Aviação
  159. | Feature | Fonte | Tools |
  160. |---------|-------|:-----:|
  161. | `opensky` | OpenSky Network — voos ao vivo via ADS-B (rastreamento, tracks) | 6 |
  162. ### Saúde
  163. | Feature | Fonte | Tools |
  164. |---------|-------|:-----:|
  165. | `saude` | CNES/DataSUS — estabelecimentos, profissionais, leitos | 10 |
  166. | `opendatasus` | OpenDataSUS — datasets de saúde pública (CKAN) | 7 |
  167. | `anvisa` | ANVISA — bulário, medicamentos, preços CMED, registros | 10 |
  168. | `denasus` | DENASUS — auditorias do SUS | 5 |
  169. | `imunizacao` | SI-PNI — vacinação, calendário, cobertura vacinal, SRAG | 10 |
  170. | `bps` | BPS — preços de medicamentos e dispositivos médicos no SUS | 3 |
  171. | `farmacia_popular` | Farmácia Popular — medicamentos gratuitos, farmácias credenciadas | 8 |
  172. | `rename` | RENAME — medicamentos essenciais do SUS por princípio ativo | 5 |
  173. ### Segurança Pública
  174. | Feature | Fonte | Tools |
  175. |---------|-------|:-----:|
  176. | `atlas_violencia` | Atlas da Violência (IPEA/FBSP) — homicídios, violência por gênero/raça, armas de fogo | 7 |
  177. | `sinesp` | SINESP/MJSP — datasets de segurança pública, sistema penitenciário | 6 |
  178. | `forum_seguranca` | Fórum Brasileiro de Segurança Pública — publicações, Anuário | 4 |
  179. ### Educação
  180. | Feature | Fonte | Tools |
  181. |---------|-------|:-----:|
  182. | `inep` | INEP — índices educacionais (IDEB, indicadores) e pesquisas | 4 |
  183. | `fnde` | FNDE — repasses, merenda escolar, PNATE, transporte | 4 |
  184. ### Compras Públicas
  185. | Feature | Fonte | Tools |
  186. |---------|-------|:-----:|
  187. | `compras` | PNCP + ComprasNet/SIASG — licitações, contratos, pregões, CATMAT | 29 |
  188. | `transferegov` | TransfereGov — emendas parlamentares PIX | 5 |
  189. ### Mercado Financeiro e Notícias
  190. | Feature | Fonte | Tools |
  191. |---------|-------|:-----:|
  192. | `b3` | Bolsa B3 (brapi.dev) — cotações ações/FIIs/BDRs, históricos, índices | 6 |
  193. | `noticias` | RSS agregado — Câmara, Senado, Agência Brasil, BCB | 4 |
  194. ### Dados Abertos e Utilidades
  195. | Feature | Fonte | Tools |
  196. |---------|-------|:-----:|
  197. | `brasilapi` | BrasilAPI — CEP, CNPJ, DDD, bancos, câmbio, FIPE, PIX | 16 |
  198. | `dados_abertos` | Dados Abertos (dados.gov.br) — catálogo de datasets federais | 4 |
  199. | `diario_oficial` | Querido Diário + DOU — diários oficiais de 5.000+ cidades e da União | 11 |
  200. | `tabua_mares` | Tábua de Marés — previsão de marés para portos do litoral | 7 |
  201. ### Datasets locais (opt-in via env)
  202. Features que baixam CSVs/ZIPs grandes (~100MB–1,6GB) para **DuckDB embedded local**
  203. e expõem SQL via tools canned. Ativadas apenas quando listadas em `MCP_BRASIL_DATASETS`.
  204. Primeira carga: minutos (download + ingest); subsequentes: ms.
  205. | Feature | Fonte | Período | Tools |
  206. |---------|-------|---------|:-----:|
  207. | `spu_siapa` | SPU — imóveis da União (SIAPA completo, 813k imóveis com dominiais + uso especial) | 2026 snapshot | 8 |
  208. | `tse_candidatos` | TSE — candidatos de todas as eleições (~4M registros) | 2014-2024 | 8 |
  209. | `tse_bens` | TSE — bens declarados por candidatos, join via `sq_candidato` | 2014-2024 | 5 |
  210. | `tse_votacao` | TSE — votos por candidato × município × zona | 2014-2024 | 6 |
  211. | `tse_redes_sociais` | TSE — URLs Instagram/Facebook/Twitter dos candidatos | 2018-2024 | 4 |
  212. | `tse_fefc` | TSE — Fundo Eleitoral Especial (distribuição partido × gênero) | 2020, 2024 | 4 |
  213. | `anp_precos` | ANP — preços semanais de combustíveis (gasolina/etanol, diesel/GNV, GLP) em postos | 2024 integral | 7 |
  214. | `inep_censo_escolar` | INEP — Censo Escolar da Educação Básica (~180k escolas, infraestrutura, matrículas) | 2023 | 7 |
  215. | `inep_enem` | INEP — Microdados ENEM (~3,9M inscritos, notas, perfil socioeconômico) | 2023 | 6 |
  216. | `isp_rj` | ISP-RJ — estatísticas criminais mensais por CISP do Rio de Janeiro | 1991-present | 6 |
  217. | `anac_rab` | ANAC — Registro Aeronáutico Brasileiro (~75k aeronaves civis) | snapshot semanal | 6 |
  218. | `anac_vra` | ANAC — Voos Regulares Ativos (pontualidade, atrasos, origem/destino) | 2020-present | — |
  219. | `cvm_fundos` | CVM — Cadastro de Fundos de Investimento (~40k fundos, PL, taxa adm, gestor) | snapshot diário | 6 |
  220. Ative com:
  221. ```bash
  222. # .env
  223. MCP_BRASIL_DATASETS=tse_candidatos,tse_bens,tse_votacao
  224. ```
  225. Ver [guia de Datasets locais](docs/guide/datasets.md) para detalhes de uso.
  226. > O server raiz também expõe 5 meta-tools: `listar_features`, `recomendar_tools`,
  227. > `planejar_consulta`, `executar_lote` e `listar_datasets_disponiveis`.
  228. ## Chaves de API
  229. | API | Obrigatória? | Como obter |
  230. |-----|-------------|------------|
  231. | Portal da Transparência | Opcional | [Cadastro gratuito](https://portaldatransparencia.gov.br/api-de-dados/cadastrar-email) |
  232. | DataJud/CNJ | Opcional | [Cadastro gratuito](https://datajud-wiki.cnj.jus.br/api-publica/acesso) |
  233. | Anúncios Eleitorais (Meta) | Opcional | [Meta Ad Library API](https://www.facebook.com/ads/library/api/) |
  234. | brapi.dev (B3) | Opcional | [Token gratuito](https://brapi.dev/dashboard) para índices e múltiplas ações |
  235. | Todas as outras (62) | Nenhuma chave | — |
  236. Configure via variáveis de ambiente ou `.env`:
  237. ```bash
  238. TRANSPARENCIA_API_KEY=sua-chave
  239. DATAJUD_API_KEY=sua-chave
  240. META_ACCESS_TOKEN=seu-token
  241. ```
  242. ## Configuração
  243. | Variável | Default | Descrição |
  244. |----------|---------|-----------|
  245. | `TRANSPARENCIA_API_KEY` | — | Chave do Portal da Transparência |
  246. | `DATAJUD_API_KEY` | — | Chave do DataJud/CNJ |
  247. | `META_ACCESS_TOKEN` | — | Token da [Meta Ad Library API](https://www.facebook.com/ads/library/api/) |
  248. | `MCP_BRASIL_TOOL_SEARCH` | `bm25` | Modo de discovery: `bm25`, `code_mode` ou `none` |
  249. | `MCP_BRASIL_HTTP_TIMEOUT` | `30.0` | Timeout HTTP em segundos |
  250. | `MCP_BRASIL_HTTP_MAX_RETRIES` | `3` | Máximo de retentativas HTTP |
  251. | `MCP_BRASIL_DATASETS` | — | Lista CSV de datasets locais a ativar. Ex: `tse_candidatos,tse_bens` |
  252. | `MCP_BRASIL_DATASET_CACHE_DIR` | `~/.cache/mcp-brasil` | Diretório raiz do cache DuckDB |
  253. | `MCP_BRASIL_DATASET_REFRESH` | `auto` | `auto` (TTL), `never` (só cache) ou `force` (sempre baixar) |
  254. | `MCP_BRASIL_DATASET_TIMEOUT` | `600` | Timeout (s) do download de datasets grandes |
  255. | `MCP_BRASIL_LGPD_ALLOW_PII` | — | Lista CSV de datasets com PII liberada (ex: `tse_candidatos`) |
  256. ## Documentação
  257. | Página | Descrição |
  258. |--------|-----------|
  259. | [Quick Start](docs/guide/quickstart.md) | Instalação e configuração em 2 minutos |
  260. | [Arquitetura](docs/concepts/architecture.md) | Como o projeto funciona por dentro |
  261. | [Catálogo de Features](docs/reference/features.md) | Todas as 69 features e 525 tools |
  262. | [Datasets locais (DuckDB)](docs/guide/datasets.md) | SIAPA + TSE 2014-2024 via SQL embedded |
  263. | [Smart Tools](docs/reference/smart-tools.md) | Meta-tools: planner, batch, discovery |
  264. | [Adicionando Features](docs/guide/adding-features.md) | Guia para contribuir com novas APIs |
  265. | [Configuração](docs/reference/configuration.md) | Variáveis de ambiente e opções |
  266. | [Meta Ad Library API](docs/reference/meta-ad-library-api.md) | Referência da API de anúncios eleitorais da Meta |
  267. | [Code Mode](docs/reference/code-mode.md) | Discovery programático + sandbox Python (experimental) |
  268. | [Desenvolvimento](docs/guide/development.md) | Setup de dev, testes, lint, CI |
  269. | [Deploy Azure (datasets)](docs/deploy/azure-datasets.md) | Container Apps + Azure Files + warmup automático dos datasets |
  270. ## Desenvolvimento
  271. ```bash
  272. git clone https://github.com/Mcp-Brasil/mcp-brasil.git
  273. cd mcp-brasil
  274. make dev # Instalar dependências (prod + dev)
  275. make test # Rodar todos os testes
  276. make test-feature F=ibge # Testes de uma feature
  277. make lint # Lint + format check
  278. make ruff # Auto-fix lint + format
  279. make types # mypy strict
  280. make ci # lint + types + test
  281. make run # Server stdio
  282. make serve # Server HTTP :8000
  283. make inspect # Listar tools/resources/prompts
  284. ```
  285. ## Arquitetura
  286. O projeto usa **Package by Feature** com **Auto-Registry** — cada feature é uma pasta auto-contida:
  287. ```
  288. src/mcp_brasil/
  289. ├── server.py # Auto-registry (nunca editado manualmente)
  290. ├── _shared/ # Utilitários compartilhados
  291. │ └── datasets/ # Infra DuckDB local
  292. ├── data/ # 51 features — REST passthrough
  293. │ ├── ibge/
  294. │ │ ├── __init__.py # FEATURE_META
  295. │ │ ├── server.py # FastMCP instance
  296. │ │ ├── tools.py # Lógica das tools
  297. │ │ ├── client.py # HTTP async
  298. │ │ ├── schemas.py # Pydantic models
  299. │ │ └── constants.py # URLs, códigos
  300. │ ├── bacen/
  301. │ └── ...
  302. ├── datasets/ # 12 features — cache local DuckDB (opt-in via env)
  303. │ ├── spu_siapa/ # SIAPA 813k imóveis
  304. │ ├── tse_candidatos/ # TSE candidatos 2014-2024
  305. │ └── ...
  306. └── agentes/ # 1 feature — agentes inteligentes
  307. └── redator/
  308. ```
  309. Três modalidades de feature coexistem:
  310. - **`data/`** — REST passthrough: HTTP async → Pydantic → tool formatada
  311. - **`datasets/`** — DuckDB embedded local: CSVs/ZIPs grandes com SQL,
  312. gated por `MCP_BRASIL_DATASETS`, cache em `~/.cache/mcp-brasil/`
  313. - **`agentes/`** — Agentes inteligentes: tools + prompts + resources
  314. compondo fluxos complexos (ex: redação oficial)
  315. Para adicionar uma nova feature, basta criar o diretório seguindo a convenção — o registry descobre automaticamente.
  316. ## Contribuindo
  317. 1. Fork o repositório
  318. 2. Crie uma feature em `src/mcp_brasil/data/{feature}/` ou `agentes/{feature}/`
  319. 3. Exporte `FEATURE_META` no `__init__.py` e `mcp: FastMCP` no `server.py`
  320. 4. Adicione testes em `tests/data/{feature}/`
  321. 5. Rode `make ci` e abra um PR
  322. ## Disclaimer
  323. 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.
  324. 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.
  325. 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.**
  326. ### Não-oficialidade
  327. `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.
  328. ### Conformidade legal
  329. 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**:
  330. - [SOURCES.md](SOURCES.md) — licença e disclaimer de cada uma das 70 fontes
  331. - [ACCEPTABLE_USE.md](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.)
  332. - [NOTICE](NOTICE) — escopo da licença MIT e atribuições
  333. ## Licença
  334. - **Código deste repositório:** [MIT](LICENSE)
  335. - **Dados retornados pelas APIs:** licenças variadas — ver [SOURCES.md](SOURCES.md)
  336. - **Uso do servidor:** sujeito à [Política de Uso Aceitável](ACCEPTABLE_USE.md)
  337. - **Atribuições e disclaimers:** [NOTICE](NOTICE)
  338. ## Star History
  339. <a href="https://www.star-history.com/?repos=Mcp-Brasil%2Fmcp-brasil&type=date&legend=top-left">
  340. <picture>
  341. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=Mcp-Brasil/mcp-brasil&type=date&theme=dark&legend=top-left" />
  342. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=Mcp-Brasil/mcp-brasil&type=date&legend=top-left" />
  343. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=Mcp-Brasil/mcp-brasil&type=date&legend=top-left" />
  344. </picture>
  345. </a>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.