# io.github.SidneyBissoli/senado-br-mcp (npm · senado-br-mcp)

MCP Server for Brazilian Federal Senate open data (legislators, bills, votes)

- Trust score: 81/100 (high trust)
- Change this week: +28
- Registry status: deprecated
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

> **Deprecated**: this server is marked deprecated in the MCP registry.

## Components

- npm · `senado-br-mcp`: 81/100 (this document), [markdown](https://verifymcp.io/servers/sidneybissoli-senado-br-mcp/senado-br-mcp.md), [page](https://verifymcp.io/servers/sidneybissoli-senado-br-mcp/senado-br-mcp)

## Channel facts

- Registry: `npm`
- Package: `senado-br-mcp`
- Version: `1.2.0`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (159 of 162), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (159 of 162), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to SidneyBissoli/senado-br-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 25 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 85/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 2057 tokens (~58/item across 35 items; 33 tools + 2 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 99/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 98% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add sidneybissoli-senado-br-mcp -- npx -y senado-br-mcp
```

### Codex

```bash
codex mcp add sidneybissoli-senado-br-mcp -- npx -y senado-br-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sidneybissoli-senado-br-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "senado-br-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add sidneybissoli-senado-br-mcp --command npx --arg -y --arg senado-br-mcp
```

### Hermes

```yaml
mcp_servers:
  sidneybissoli-senado-br-mcp:
    command: "npx"
    args: ["-y", "senado-br-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "sidneybissoli-senado-br-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "senado-br-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 81, +55)

- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Provenance: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] The attested source repository moved: SidneyBissoli/senado-br-mcp
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Security disclosure: fail → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Stability: unverified → 0.23
- [functional improvement] MCP protocol: unverified → pass
- [functional] Licence: MIT

### 2026-07-31 (score 26, −27)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 53, +28)

- [functional regression] Dependency health: partial → unverified
- [functional improvement] Schema quality: unverified → 100
- [functional improvement] Tool coverage: unverified → 100

### 2026-07-28 (score 25, −28)

- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional improvement] Dependency health: unverified → partial

### 2026-07-27 (score 53)

First indexed and scored.

## MCP tools (33)

### `senado_listar_senadores` (~111 tokens)

Lista senadores em exercício ou de uma legislatura específica. Pode filtrar por UF e partido.

Input parameters:

- `emExercicio` (boolean): Filtrar apenas senadores em exercício
- `legislatura` (integer): Número da legislatura (ex: 57 para 2023-2027)
- `partido` (string): Sigla do partido (ex: PT, PL, MDB)
- `uf` (string): Sigla do estado (ex: SP, RJ, MG)

### `senado_obter_senador` (~51 tokens)

Obtém informações detalhadas de um senador específico, incluindo dados biográficos, mandatos e comissões.

Input parameters:

- `codigoSenador` (integer, required): Código único do senador no sistema do Senado

### `senado_buscar_senador_por_nome` (~53 tokens)

Busca senadores por nome (útil quando não se tem o código). Retorna lista de senadores correspondentes.

Input parameters:

- `nome` (string, required): Nome ou parte do nome do senador

### `senado_votacoes_senador` (~84 tokens)

Lista votações de um senador específico, mostrando como o senador votou em cada matéria.

Input parameters:

- `ano` (integer): Ano das votações
- `codigoSenador` (integer, required): Código único do senador
- `dataFim` (string): Data fim (YYYYMMDD)
- `dataInicio` (string): Data início (YYYYMMDD)

### `senado_buscar_materias` (~143 tokens)

Busca matérias legislativas por diversos critérios: tipo (PEC, PL, PLP, MPV), número, ano, palavras-chave, autor ou relator.

Input parameters:

- `ano` (integer): Ano da matéria
- `autorNome` (string): Nome do autor
- `numero` (integer): Número da matéria
- `palavraChave` (string): Busca na ementa
- `relatorNome` (string): Nome do relator
- `sigla` (string): Tipo: PEC, PL, PLP, MPV, PDL, PRS, etc.
- `tramitando` (boolean): Apenas em tramitação

### `senado_obter_materia` (~47 tokens)

Obtém detalhes completos de uma matéria legislativa, incluindo ementa, autoria, situação atual e relator.

Input parameters:

- `codigoMateria` (integer, required): Código único da matéria

### `senado_tramitacao_materia` (~45 tokens)

Obtém histórico de tramitação de uma matéria, mostrando todas as movimentações em ordem cronológica.

Input parameters:

- `codigoMateria` (integer, required): Código único da matéria

### `senado_textos_materia` (~46 tokens)

Obtém textos disponíveis de uma matéria (inicial, substitutivo, final) com URLs para download.

Input parameters:

- `codigoMateria` (integer, required): Código único da matéria

### `senado_votos_materia` (~44 tokens)

Obtém resultado de votações de uma matéria, incluindo placar e votos nominais quando disponíveis.

Input parameters:

- `codigoMateria` (integer, required): Código único da matéria

### `senado_listar_votacoes` (~89 tokens)

Lista votações do plenário do Senado por ano, podendo filtrar por mês ou período específico.

Input parameters:

- `ano` (integer, required): Ano das votações (obrigatório)
- `dataFim` (string): Data fim (YYYYMMDD)
- `dataInicio` (string): Data início (YYYYMMDD)
- `mes` (integer): Mês (1-12)

### `senado_obter_votacao` (~43 tokens)

Obtém detalhes de uma votação específica, incluindo votos nominais de cada senador.

Input parameters:

- `codigoVotacao` (integer, required): Código único da votação

### `senado_votacoes_recentes` (~56 tokens)

Obtém as votações mais recentes do plenário (últimos N dias). Útil para acompanhar atividade legislativa recente.

Input parameters:

- `dias` (integer): Quantidade de dias (padrão: 7)

### `senado_listar_comissoes` (~75 tokens)

Lista comissões do Senado. Pode filtrar por tipo (permanente, temporária, CPI, mista) e status (ativa/inativa).

Input parameters:

- `ativa` (boolean): Apenas comissões ativas
- `tipo` (string): Tipo: permanente, temporaria, cpi, mista

### `senado_obter_comissao` (~47 tokens)

Obtém detalhes de uma comissão, incluindo presidente, vice-presidente e finalidade.

Input parameters:

- `sigla` (string, required): Sigla da comissão (ex: CCJ, CAE)

### `senado_membros_comissao` (~44 tokens)

Lista membros atuais de uma comissão, incluindo cargo (presidente, vice, titular, suplente).

Input parameters:

- `sigla` (string, required): Sigla da comissão

### `senado_reunioes_comissao` (~74 tokens)

Lista reuniões agendadas ou realizadas de uma comissão, com data, hora, local e pauta.

Input parameters:

- `dataFim` (string): Data fim (YYYYMMDD)
- `dataInicio` (string): Data início (YYYYMMDD)
- `sigla` (string, required): Sigla da comissão

### `senado_agenda_plenario` (~73 tokens)

Obtém agenda de sessões do plenário do Senado, incluindo pauta com matérias a serem votadas.

Input parameters:

- `data` (string): Data específica (YYYYMMDD)
- `dataFim` (string): Data fim (YYYYMMDD)
- `dataInicio` (string): Data início (YYYYMMDD)

### `senado_agenda_comissoes` (~61 tokens)

Obtém agenda de reuniões das comissões do Senado. Pode filtrar por data e comissão específica.

Input parameters:

- `data` (string): Data específica (YYYYMMDD)
- `siglaComissao` (string): Filtrar por comissão específica

### `senado_legislatura_atual` (~33 tokens)

Retorna informações sobre a legislatura vigente, incluindo número, período e datas de início/fim.

### `senado_tipos_materia` (~37 tokens)

Lista os tipos de matérias legislativas válidos com sigla, nome completo e descrição. Útil para usar em buscas.

### `senado_partidos` (~30 tokens)

Lista partidos com representação atual no Senado, incluindo sigla, nome completo e número de senadores.

### `senado_ufs` (~25 tokens)

Lista unidades federativas com número de senadores atualmente em exercício por estado.

### `senado_ecidadania_listar_consultas` (~66 tokens)

Lista consultas públicas do e-Cidadania com votação cidadã sobre matérias em tramitação.

Input parameters:

- `limite` (integer): Número máximo de resultados
- `pagina` (integer): Página de resultados
- `status` (string): Filtrar por status

### `senado_ecidadania_obter_consulta` (~42 tokens)

Obtém detalhes de uma consulta pública específica, incluindo votos, autor e comentários.

Input parameters:

- `id` (integer, required): ID da consulta pública

### `senado_ecidadania_consultas_polarizadas` (~83 tokens)

Retorna consultas com votação equilibrada (~50/50), útil para identificar temas polarizados na sociedade.

Input parameters:

- `limite` (integer): Número máximo de resultados
- `margemPolarizacao` (integer): Considera polarizado se diferença < este percentual
- `minimoVotos` (integer): Mínimo de votos para considerar

### `senado_ecidadania_consultas_consensuais` (~80 tokens)

Retorna consultas com alta concordância (>85% em uma direção), útil para identificar temas de consenso.

Input parameters:

- `limite` (integer): Número máximo de resultados
- `minimoVotos` (integer): Mínimo de votos para considerar
- `percentualMinimo` (integer): Percentual mínimo em uma direção

### `senado_ecidadania_listar_ideias` (~84 tokens)

Lista ideias legislativas propostas por cidadãos no e-Cidadania.

Input parameters:

- `limite` (integer): Número máximo de resultados
- `ordem` (string): Ordem de ordenação
- `ordenarPor` (string): Campo para ordenação
- `pagina` (integer): Página de resultados
- `status` (string): Filtrar por status

### `senado_ecidadania_obter_ideia` (~51 tokens)

Obtém detalhes de uma ideia legislativa, incluindo descrição completa, apoios e se foi convertida em PL.

Input parameters:

- `id` (integer, required): ID da ideia legislativa

### `senado_ecidadania_ideias_populares` (~55 tokens)

Retorna as ideias legislativas mais apoiadas pelos cidadãos.

Input parameters:

- `apenasAbertas` (boolean): Apenas ideias com apoiamento aberto
- `limite` (integer): Número máximo de resultados

### `senado_ecidadania_listar_eventos` (~71 tokens)

Lista eventos interativos (audiências públicas, sabatinas, lives) do e-Cidadania.

Input parameters:

- `comissao` (string): Sigla da comissão
- `limite` (integer): Número máximo de resultados
- `status` (string): Filtrar por status

### `senado_ecidadania_obter_evento` (~43 tokens)

Obtém detalhes de um evento interativo, incluindo pauta, convidados e link para vídeo.

Input parameters:

- `id` (integer, required): ID do evento

### `senado_ecidadania_eventos_populares` (~52 tokens)

Retorna eventos com mais comentários e perguntas dos cidadãos.

Input parameters:

- `apenasAgendados` (boolean): Apenas eventos ainda não realizados
- `limite` (integer): Número máximo de resultados

### `senado_ecidadania_sugerir_tema_enquete` (~52 tokens)

Analisa e sugere temas para enquete mensal baseado em critérios configuráveis. Evita temas muito polarizados ou com consenso total.

Input parameters:

- `criterios` (object)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/sidneybissoli-senado-br-mcp/senado-br-mcp#diagnostics

## Score history

- 2026-08-03: 81
- 2026-08-02: 81
- 2026-08-01: 26
- 2026-07-31: 26
- 2026-07-30: 53
- 2026-07-28: 25
- 2026-07-27: 53

## Links

- npm package: https://www.npmjs.com/package/senado-br-mcp
- Socket report: https://socket.dev/npm/package/senado-br-mcp
- Repository: https://github.com/SidneyBissoli/senado-br-mcp
- Changelog RSS feed: https://verifymcp.io/servers/sidneybissoli-senado-br-mcp/senado-br-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/sidneybissoli-senado-br-mcp/senado-br-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/sidneybissoli-senado-br-mcp/senado-br-mcp