Back to Browse

Painel Emendas MCP Server

Developer ToolsLow Risk8.5MCP RegistryRemote
Free

Server data from the Official MCP Registry

Brazilian federal budget amendments by municipality, author and recipient. Paid via Lightning.

About

Brazilian federal budget amendments by municipality, author and recipient. Paid via Lightning.

Remote endpoints: streamable-http: https://painel-emendas.pages.dev/mcp

Security Report

8.5
Low Risk8.5Low Risk

Valid MCP server (1 strong, 0 medium validity signals). 3 known CVEs in dependencies Imported from the Official MCP Registry.

6 tools verified · Open access · 3 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

file_system

Applies to the server that hosts this plugin, not to your machine.

clipboard

Applies to the server that hosts this plugin, not to your machine.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-projects-betanull-painel-emendas": {
      "url": "https://painel-emendas.pages.dev/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Painel de Emendas — ETL (semana 1)

Baixa as emendas parlamentares do Portal da Transparência, liga cada linha ao município (código IBGE) e gera as tabelas do painel. Roda de graça todo dia no GitHub Actions.

O que sai em data/out/

ArquivoConteúdo
fato_emenda.parquetUma linha por emenda × localidade × ano, com valores empenhado / liquidado / pago, escopo (municipal, estadual, regional, nacional, outro), municipio_ibge, uf e modalidade (pix / outras)
fato_favorecido.parquetQuem recebeu o dinheiro de cada emenda (CNPJ, natureza jurídica), por mês, com municipio_ibge
metricas_municipio.parquetValor recebido por município e ano (a partir dos favorecidos), nº de emendas, autores e favorecidos, posição no ranking da UF
autores.parquetTotais por parlamentar (ou bancada/comissão) e ano
qualidade.json% do valor pago que foi ligado a um município e as 20 localidades não resolvidas de maior valor

Rodar no seu computador

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m pytest -q          # testes com a amostra em tests/fixtures
python -m etl.build          # baixa os dados reais e gera data/out/

ANO_INICIAL=2015 python -m etl.build muda o primeiro ano (padrão: 2020).

Colocar no ar (custo zero)

  1. Crie um repositório público no GitHub e suba esta pasta (Actions é ilimitado em repositório público).
  2. Em Actions, rode o workflow "ETL diário de emendas" na mão uma vez e baixe o artefato qualidade.
  3. Quando quiser publicar os dados: crie um bucket no Cloudflare R2 e, em Settings → Secrets and variables → Actions, cadastre R2_ACCOUNT_ID, R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEY e R2_BUCKET. Sem esses segredos o workflow só gera e guarda o relatório.

Resultado da primeira execução real (02/11/2026)

  • 46.510 emendas desde 2020 e 654.094 pagamentos a favorecidos.
  • No arquivo principal, 83% do valor pago vem com localidade "MÚLTIPLO"; por isso o total por município usa o arquivo de favorecidos.
  • 99,8% do valor recebido ficou ligado a um município (5.568 municípios). O resto é "Sem informação" na própria fonte.
  • A API do IBGE não responde a partir do GitHub; a lista de municípios vem de uma cópia pública no GitHub.

Pontos a conferir

  • Nomes das colunas do CSV: o código aceita variações (etl/normalize.py, dicionário COLUNAS). Se o Portal mudar um rótulo, o build para e lista as colunas encontradas; basta acrescentar o novo nome ali.
  • Formato da localidade: os padrões reconhecidos são CIDADE - UF, CIDADE/UF, ESTADO (UF), REGIÃO (REGIÃO) e NACIONAL. O qualidade.json mostra o que sobrou; grafias diferentes entram em ALIASES_MUNICIPIO.
  • Emendas Pix: identificadas pelo nome da ação ("Transferência Especial"). Conferir com o tipo de emenda do arquivo real.
  • Acesso ao Portal a partir do GitHub: se o download falhar por bloqueio de IP estrangeiro, a alternativa é rodar o ETL no seu computador e subir os arquivos para o R2.

Próximas etapas

  • Semana 2: Transferegov (planos de ação das Emendas Pix) e população do IBGE para valor por habitante.
  • Semanas 3–4: páginas estáticas por município e parlamentar.

Reviews

No reviews yet

Be the first to review this server!