Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

Dados Abertos Senado BR MCP

NPM · SENADO-BR-MCP · 2 COMPONENTS · SCANNED AUG 3

MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).

+18 this week 68 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security86
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability70
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 20070 tokens (~282/item across 71 items; 66 tools + 5 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · senado-br-mcp

# add to Claude Code
claude mcp add sidneybissoli-senado-br-mcp-cloudflare -- npx -y senado-br-mcp
# add to Codex CLI
codex mcp add sidneybissoli-senado-br-mcp-cloudflare -- npx -y senado-br-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sidneybissoli-senado-br-mcp-cloudflare": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "senado-br-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add sidneybissoli-senado-br-mcp-cloudflare --command npx --arg -y --arg senado-br-mcp
# ~/.hermes/config.yaml
mcp_servers:
  sidneybissoli-senado-br-mcp-cloudflare:
    command: "npx"
    args: ["-y", "senado-br-mcp"]
// mcp.json
{
  "mcpServers": {
    "sidneybissoli-senado-br-mcp-cloudflare": {
      "command": "npx",
      "args": [
        "-y",
        "senado-br-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 +4
    • Stability: unverified → 0.27 functional
  • 2 Aug 26 +40
    • Provenance: unverified → fail security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Tool coverage: 100 → unverified functional
    • Schema quality: 100 → unverified functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • Schema quality: unverified → good functional
    • MCP protocol: unverified → pass functional
    • License: unverified → pass functional
    • Licence: MIT functional
  • 1 Aug 26 +19
    • Schema quality: unverified → 100 functional
    • Tool coverage: unverified → 100 functional
  • 31 Jul 26 −45
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 27 Jul 26 50

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 66 exposed · ~19,183 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
senado_search_processos ~321

Busca processos legislativos no endpoint v3 `/processo` (parâmetros complementares ao `senado_buscar_materias`). Retorna `{ count, total, aviso?, processos }`, cada item com `id`, `codigoMateria`, `identificacao`, `ementa`, `tipoDocumento`, `dataApresentacao`, `autoria` (compactada: primeiros autores + total), `totalAutores`, `tramitando` (boolean) e `normaGerada`. É obrigatório ao menos um filtro (sigla, número, ano, autor ou período). Limitado a `limite` (padrão 20, máx. 200), com `aviso` ao truncar. Use o `id` retornado em `senado_obter_processo` para detalhes.

NameTypeReqDescription
anointegerAno do processo
autorstringNome do autor
codigoParlamentarAutorintegerCódigo do parlamentar autor
dataFimApresentacaostringData fim da apresentação (YYYYMMDD ou YYYY-MM-DD)
dataInicioApresentacaostringData início da apresentação (YYYYMMDD ou YYYY-MM-DD)
limiteintegerMáximo de resultados (padrão: 20)
numerointegerNúmero do processo
siglastringSigla do tipo de processo (ex: PL, PEC)
tramitandostringEm tramitação (S/N)

Structured output declared, but exposes no named fields.

No examples provided.

senado_search_votacoes ~375

Busca e lista votações do plenário combinando critérios opcionais. Janela temporal: informe `dias` (últimos N dias, 1-365) para atividade recente, OU `dataInicio`/`dataFim` (YYYYMMDD) para um período arbitrário — para um ano inteiro use `dataInicio: "AAAA0101"` e `dataFim: "AAAA1231"`. Demais filtros: `idProcesso`, `codigoMateria`, `sigla`/`numero`/`ano` da matéria, `codigoParlamentar` e `siglaVotoParlamentar`. Retorna `{ count, votacoes }` ordenadas da mais recente para a mais antiga; cada item traz `codigoSessao`, `data`, `materia`, `codigoMateria`, `resultado` e placar (`totalSim`/`totalNao`/`totalAbstencao`), sem votos nominais. Use `senado_obter_votacao` com o `codigoSessao` para os votos de cada senador.

NameTypeReqDescription
anointegerAno da matéria
codigoMateriaintegerCódigo da matéria
codigoParlamentarintegerCódigo do parlamentar
dataFimstringData fim (YYYYMMDD)
dataIniciostringData início (YYYYMMDD)
diasintegerJanela: votações dos últimos N dias (ignorado se dataInicio/dataFim forem informados)
idProcessointegerID do processo legislativo
numerointegerNúmero da matéria
siglastringSigla do tipo de matéria
siglaVotoParlamentarstringTipo de voto do parlamentar

Structured output declared, but exposes no named fields.

No examples provided.

senado_senador_historico ~255

Histórico funcional de um senador conforme o parâmetro `tipo`. Valores: `licencas` (itens com `dataInicio`/`dataFim`/`descricao`), `comissoes` (`sigla`/`nome`/`casa`/`participacao`/datas), `cargos` (`comissao`/`cargo`/datas), `historico-academico` (cursos, registros brutos da API), `filiacoes` (`partido`/`nomePartido`/`dataFiliacao`/`dataDesfiliacao`) e `profissoes` (`nome`). Retorna `{ codigoSenador, tipo, count, itens }`, com a forma de cada item dependente do `tipo`; tipos sem registros para o senador retornam `count` 0 e `itens` vazio. Requer `codigoSenador` (obtenha via `senado_listar_senadores`). Para dados biográficos e mandatos use `senado_obter_senador`.

NameTypeReqDescription
codigoSenadorintegeryesCódigo único do senador
tipostringyesQual histórico consultar

Structured output declared, but exposes no named fields.

No examples provided.

senado_senadores_admin ~285

Dados administrativos dos senadores conforme o parâmetro `tipo`: `auxilio-moradia` → `{ tipo, count, senadores }` (`nome`, `uf`, `partido`, `auxilioMoradia`, `imovelFuncional`; legislatura atual). `escritorios-apoio` → `{ tipo, count, escritorios }` (`senador`, `uf`, `partido`, `setor`, `endereco`, `telefone`). `aposentados` → `{ tipo, count, aposentados }` ex-senadores aposentados pelos planos de previdência do Congresso (IPC e PSSC), com `nome`, `tipo` do plano, `dataInicial`, `remuneracao`. Filtros opcionais `uf` e `nome` (busca parcial) aplicam-se a auxilio-moradia e escritorios-apoio; `nome` também filtra aposentados. Cada `tipo` retorna `count` 0 e lista vazia quando não há registros. Para gastos de cota parlamentar use `senado_ceaps`.

NameTypeReqDescription
nomestringFiltrar por nome do senador (busca parcial)
tipostringyesQual dado administrativo consultar
ufstringFiltrar por estado (auxilio-moradia/escritorios-apoio)

Structured output declared, but exposes no named fields.

No examples provided.

senado_senadores_afastados ~115

Lista os senadores atualmente afastados (fora de exercício). Retorna `{ count, senadores }`, cada item com `codigo`, `nome`, `nomeCompleto`, `partido`, `uf`, `foto` e `emExercicio` (sempre `false`). Não requer parâmetros. Use `codigo` em `senado_obter_senador` para o detalhe; para os senadores em exercício (e busca por nome) use `senado_listar_senadores`.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

senado_servidores ~247

Lista servidores do Senado por `situacao` (ativos, efetivos, comissionados ou inativos), com filtros opcionais por `nome`, `lotacao` e `cargo`. Retorna `{ situacao, count, total, servidores[] }`, cada item com `nome`, `vinculo`, `situacao`, `cargo`, `funcao`, `lotacao`, `anoAdmissao` etc. Aplica `limite` (padrão 50, máx 500) e inclui `aviso` quando há truncamento — refine os filtros. Para remuneração use `senado_remuneracoes_servidores`; para estagiários/pensionistas/quantitativos use `senado_pessoal_tabelas`.

NameTypeReqDescription
cargostringCargo (busca parcial)
limiteintegerMáximo de resultados (padrão: 50)
lotacaostringLotação/setor (busca parcial, ex: SEGRAF)
nomestringNome do servidor (busca parcial)
situacaostringQual lista consultar (padrão: ativos)

Structured output declared, but exposes no named fields.

No examples provided.

senado_suprimento_fundos ~580

Suprimento de fundos do Senado (adiantamentos a supridos): relação anual de supridos, atos de concessão, empenhos, movimentações ou transações de cartão corporativo, conforme `tipo`. Retorna `{ ano, tipo, count, total, registros }` (snake_case da API administrativa), filtrável por `filtro` textual e limitado por `limite` (padrão 100, máx 500); ao truncar, inclui `aviso`. Para maior/menor/média/mediana/distribuição/ranking ('quem mais recebeu', 'fornecedor com maior gasto', 'valor mediano') use `estatisticas=true` (só nos tipos `transacoes`, `empenhos`, `atos-concessao` — os demais não têm coluna de valor): SEM `agruparPor` = distribuição das linhas (min/máx/média/mediana/percentis) + top/bottom; COM `agruparPor` = grupos ranqueados por soma do `campo` (grupos[0]=maior). `campo` escolhe a coluna (transacoes: `valor`; empenhos padrão `valorExecutado`; atos-concessao padrão `valorTotalTransacoes`); `campo`/`agruparPor` inválidos para o `tipo` caem no default com `aviso`, e registros sem valor numérico são excluídos das estatísticas. Informe o `ano` (>=2010); use os mesmos códigos administrativos vistos em `senado_contratacoes_lista` ou `senado_execucao_orcamentaria` para cruzar gastos.

NameTypeReqDescription
agruparPorstringRanquear grupos por soma do campo (transacoes: fornecedor/tipo/tipoInscricao/rubricas; empenhos: rubrica/descricao; atos-concessao: elementoDespesa/regimeEspecial)
anointegeryesAno de referência
campostringColuna de valor para estatísticas (transacoes: valor; empenhos padrão valorExecutado; atos-concessao padrão valorTotalTransacoes)
estatisticasbooleanDistribuição/ranking sobre as linhas: min/máx/média/mediana/percentis + top/bottom, ou grupos ranqueados por soma via agruparPor. Só para tipo transacoes/empenhos/atos-concessao
filtrostringFiltro textual (nome, unidade...)
limiteintegerMáximo de resultados (padrão: 100)
tipostringQual relação consultar (padrão: supridos)
topNintegerTamanho do top/bottom nas estatísticas (padrão: 10)

Structured output declared, but exposes no named fields.

No examples provided.

senado_tabelas_plenario ~306

Consulta tabelas de referência do plenário para resolver códigos/domínios, conforme `tabela`: `tipos-sessao` (espécies de sessão plenária), `tipos-comparecimento` (situações de presença) ou `legislaturas` (períodos legislativos com datas). Retorna `{ tabela, count, total, linhas }` — `count` é o nº após o corte por `limite` e `total` o disponível; `count < total` indica truncagem (aumente `limite`); `count` 0 quando o `filtro` não casa. Cada linha traz o código/sigla e a descrição do domínio (campos conforme a API). Use para interpretar campos como `tipo` de `senado_agenda_plenario`/`senado_resultado_plenario`. Para tabelas do processo legislativo (assuntos, classes, situações) use `senado_tabelas_processo`.

NameTypeReqDescription
filtrostringBusca textual sobre qualquer campo da linha; count 0 se nada casar
limiteintegerMáximo de linhas (padrão 100, máx 500); count < total sinaliza corte
tabelastringyesDomínio a consultar: tipos-sessao (espécies de sessão); tipos-comparecimento (situações de presença); legislaturas (períodos com datas)

Structured output declared, but exposes no named fields.

No examples provided.

senado_tabelas_processo ~372

Consulta tabelas de referência do processo legislativo para resolver códigos/siglas, conforme `tabela`. Domínios de entidade: `siglas` (siglas de proposição), `assuntos`, `classes`, `destinos`, `entes`. Domínios de tipo (código→descrição): `tipos-situacao`, `tipos-decisao`, `tipos-autor`, `tipos-atualizacao`, `tipos-documento`, `tipos-conteudo-documento`, `tipos-prazo`. Retorna `{ tabela, count, total, linhas }` — `count` é o nº após o corte por `limite` e `total` o disponível; `count < total` indica truncagem (aumente `limite`); `count` 0 quando o `filtro` não casa. Cada linha traz código/sigla e descrição (campos conforme a API). Use antes de filtrar em `senado_search_processos`/`senado_processo_detalhe`. Para as tabelas do plenário (tipos de sessão, legislaturas) use `senado_tabelas_plenario`.

NameTypeReqDescription
filtrostringBusca textual sobre sigla/descrição; count 0 se nada casar
limiteintegerMáximo de linhas (padrão 200, máx 1000); count < total sinaliza corte
tabelastringyesTabela a consultar — entidades (siglas, assuntos, classes, destinos, entes) ou tipos (tipos-situacao, tipos-decisao, tipos-autor, tipos-atualizacao, tipos-documento, tipos-conteudo-documento, tipos-p…

Structured output declared, but exposes no named fields.

No examples provided.

senado_tabelas_referencia ~349

Consulta tabelas de referência do Senado pelo parâmetro `tabela`. Valores: `tipos-materia` → `{ count, tipos }` (sigla/nome/descricao dos tipos de proposição, p.ex. PEC, PL, MPV) — **catálogo curado mantido neste servidor** (12 tipos mais comuns, não é a lista viva do upstream `processo/siglas`, que tem ~184 siglas); use para achar a `sigla` correta antes de `senado_buscar_materias`/`senado_search_processos`; `partidos` → `{ count, totalSenadores, partidos }` (partidos com bancada atual, ordenados por nº de senadores); `ufs` → `{ count, totalSenadores, ufs }` (as 27 UFs com a contagem de senadores em exercício); `legislatura-atual` → `{ numero, periodo, dataInicio, dataFim }` da legislatura vigente; `tipos-norma` → `{ count, tipos }` (sigla/descricao dos tipos de norma para `senado_buscar_legislacao`); `tipos-uso-palavra` → `{ count, tipos }` (codigo/descricao para interpretar `tipoUsoPalavra` em `senado_discursos_senador`). Toda resposta inclui o campo `tabela`. Para a relação nominal de parlamentares use `senado_listar_senadores`.

NameTypeReqDescription
tabelastringyesQual tabela de referência consultar: tipos-materia, partidos, ufs, legislatura-atual, tipos-norma ou tipos-uso-palavra

Structured output declared, but exposes no named fields.

No examples provided.

senado_terceirizados ~204

Lista colaboradores terceirizados do Senado, filtráveis (busca parcial, sem acento) por nome, empresa contratada ou lotação. Retorna `{ count, total, terceirizados }`, cada item com `nome`, `cpf`, `situacao`, `empresa`, `lotacao` e `numeroContrato`. A lista completa é baixada e filtrada no Worker; resultados limitados a `limite` (padrão 50, máx 500), com `aviso` ao truncar. Para a empresa contratante e seus contratos, use `senado_empresas_contratadas`.

NameTypeReqDescription
empresastringNome da empresa contratada (busca parcial)
limiteintegerMáximo de resultados (padrão: 50)
lotacaostringLotação/setor (busca parcial)
nomestringNome do colaborador (busca parcial)

Structured output declared, but exposes no named fields.

No examples provided.

senado_vetos ~237

Lista vetos presidenciais em apreciação pelo Congresso Nacional, por ano ou por status de tramitação. Retorna `{ count, total, aviso?, vetos }`, com cada veto trazendo `codigo`, `identificacao`, `ementa`, `emTramitacao`, `materiaVetada`, `tipo` (total/parcial), `assunto` e `dataLimiteVotacao` (prazo de sobrestamento de pauta). `limite` controla o corte (padrão 100; `aviso` indica truncagem). Informe `ano` OU `status` (tramitando/antes-rcn/encerrados). Para o resultado da votação de um veto use `senado_resultado_veto`.

NameTypeReqDescription
anointegerVetos do ano informado
limiteintegerMáximo de resultados (padrão: 100)
statusstringtramitando = pós-RCN 1/2013 em tramitação (padrão); antes-rcn = anteriores à RCN; encerrados = tramitação encerrada

Structured output declared, but exposes no named fields.

No examples provided.

senado_videos_taquigrafia ~284

Lista os vídeos e áudios (unidades descritivas) de uma sessão plenária ou reunião de comissão. Retorna `{ id, tipo, count, total, aviso?, videos }` (sessão sem mídia → `count`/`total` 0 e lista vazia; ao passar de `limite` inclui `aviso`), cada item com `codigo`, `data`, `descricao`, `orador`, `duracaoSegundos` e os links `urlVideo`, `urlAudio`, `urlThumbnail`. Obtenha o `id` via `senado_agenda_plenario`/`senado_resultado_plenario` (sessão) ou `senado_reuniao_comissao` (reunião). Para a transcrição textual correspondente use `senado_notas_taquigraficas`, não esta.

NameTypeReqDescription
idintegeryesCódigo da sessão plenária ou da reunião de comissão, conforme `tipo`
limiteintegerMáximo de unidades (padrão 50, máx 200); o excedente é sinalizado em aviso
oradorstringRetorna só unidades cujo orador contém este nome (busca parcial)
tipostringsessao = plenário (padrão); reuniao = comissão

Structured output declared, but exposes no named fields.

No examples provided.

senado_votacao_comissao ~537

Lista votações em comissões. O parâmetro `por` (padrão `comissao`) define o eixo da consulta: `por: comissao` → exige `siglaComissao`; lista as votações daquela comissão. `por: senador` → exige `codigoSenador`; lista os votos do senador em comissões (filtro opcional `comissao`). `por: materia` → exige `sigla`, `numero` e `ano` (ex.: PL 2630/2020); lista as votações da proposição em comissões (filtro opcional `comissao`). Em todos os casos aceita período opcional `dataInicio`/`dataFim` (YYYYMMDD, filtrado pela data da reunião) e retorna `{ por, ...contexto, count, votacoes }`, cada votação com `codigo`, `data`, `comissao`, `reuniao`, `materia`, `descricao`, totais computados dos votos (`totalSim`/`totalNao`/`totalAbstencao`) e `votos` (senador, partido, voto). Sem paginação. Obtenha siglas via `senado_listar_comissoes`, `codigoSenador` via `senado_listar_senadores`; para votações no plenário use `senado_votos_materia`. Atenção: o `codigo` de cada votação de comissão pertence a um espaço de numeração próprio e NÃO é válido em `senado_obter_votacao` (que é exclusivo de plenário) — podem coincidir numericamente, mas apontam para votações diferentes.

NameTypeReqDescription
anointegerAno da proposição (obrigatório quando por=materia)
codigoSenadorintegerCódigo do senador (obrigatório quando por=senador)
comissaostringSigla da comissão para filtrar (por=senador ou por=materia)
dataFimstringData fim (YYYYMMDD)
dataIniciostringData início (YYYYMMDD)
numerointegerNúmero da proposição (obrigatório quando por=materia)
porstringEixo da consulta: comissao, senador ou materia
siglastringSigla do tipo da proposição (obrigatório quando por=materia; ex: PL, PEC)
siglaComissaostringSigla da comissão (obrigatório quando por=comissao; ex: CCJ, CAE)

Structured output declared, but exposes no named fields.

No examples provided.

senado_votacoes_senador ~197

Lista as votações nominais de um senador, mostrando como votou em cada matéria. Retorna `{ periodo, count, votos }`, cada voto com `codigoVotacao`, `data`, `materia`, `descricao`, `voto` e `resultado`, ordenados da mais recente para a mais antiga. Sem período usa o ano corrente; informe `ano` ou o par `dataInicio`/`dataFim` (YYYYMMDD). Requer `codigoSenador` (obtenha via `senado_listar_senadores`); para detalhes de uma votação específica use `senado_obter_votacao`.

NameTypeReqDescription
anointegerAno das votações
codigoSenadorintegeryesCódigo único do senador
dataFimstringData fim (YYYYMMDD)
dataIniciostringData início (YYYYMMDD)

Structured output declared, but exposes no named fields.

No examples provided.

senado_votos_materia ~160

Obtém as votações de uma matéria pelo `codigoMateria`. Retorna `{ codigoMateria, count, votacoes }`, cada item com `data`, `descricao`, `resultado` e placar (`totalSim`/`totalNao`/`totalAbstencao`); com `incluirVotos: true` (padrão false) acrescenta `votos[]` (nome, partido, uf e voto de cada senador). Obtenha o `codigoMateria` via `senado_buscar_materias` ou `senado_obter_materia`.

NameTypeReqDescription
codigoMateriaintegeryesCódigo único da matéria
incluirVotosbooleanIncluir votos nominais de cada senador

Structured output declared, but exposes no named fields.

No examples provided.