Senado Br Mcp

> # ⚠️ Deprecated — this repository has moved > > This server is no longer maintained here. The Brazilian Senate MCP server now lives at > senado-br-mcp-cloudflare — 66 tools > with level-1 provenance, available both hosted (https://senado.sidneybissoli.com/mcp, no setup) > and via npm/stdio (npx senado-br-mcp, v3.x). The npm package senado-br-mcp now publishes that > server (v3.2.1+); versions `85% one way) - identifies broad agreement |

Legislative Ideas (Ideias Legislativas)

| Tool | Description | |------|-------------| | senado_ecidadania_listar_ideias | List citizen-proposed legislative ideas | | senado_ecidadania_obter_ideia | Get idea details including full description and conversion to bill | | senado_ecidadania_ideias_populares | Get most supported legislative ideas |

Interactive Events (Eventos Interativos)

| Tool | Description | |------|-------------| | senado_ecidadania_listar_eventos | List interactive events (hearings, confirmations, livestreams) | | senado_ecidadania_obter_evento | Get event details including agenda, guests, and video link | | senado_ecidadania_eventos_populares | Get events with most citizen comments and questions |

Analysis Tools

| Tool | Description | |------|-------------| | senado_ecidadania_sugerir_tema_enquete | AI-assisted analysis to suggest topics for monthly surveys based on participation metrics |

> Note: e-Cidadania tools use web scraping with rate limiting and caching. If the e-Cidadania website is temporarily unavailable, API tools (senators, bills, votes) remain operational.

Usage Examples

List senators from São Paulo

Use senado_listar_senadores with uf: "SP"

Search for Constitutional Amendments in 2024

Use senado_buscar_materias with sigla: "PEC", ano: 2024

Get recent votes

Use senado_votacoes_recentes with dias: 7

Find a senator by name

Use senado_buscar_senador_por_nome with nome: "Randolfe"

Get CCJ committee members

Use senado_membros_comissao with sigla: "CCJ"

Get polarized public consultations

Use senado_ecidadania_consultas_polarizadas with minimoVotos: 5000

Get most supported citizen ideas

Use senado_ecidadania_ideias_populares with limite: 5

Find upcoming interactive events

Use senado_ecidadania_listar_eventos with status: "agendado"

Response Format

All tools return structured JSON responses:

Success Response

{
  "success": true,
  "data": { ... },
  "metadata": {
    "fonte": "Senado Federal - Dados Abertos",
    "dataConsulta": "2024-01-15T10:30:00Z",
    "endpoint": "/senador/lista/atual"
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "SENADOR_NAO_ENCONTRADO",
    "message": "Senator with code 99999 was not found",
    "suggestion": "Use senado_buscar_senador_por_nome to find the correct code"
  }
}

Development

Prerequisites

• Node.js 18+
• npm

Setup

npm install

Build

# Build stdio version (npm package)
npm run build

# Build HTTP server version
npm run build:server

# Build both
npm run build:all

Development Mode

# stdio mode
npm run dev

# HTTP server mode
npm run dev:server

Type Check

npm run typecheck

Test with MCP Inspector

npm run inspect

---

Self-Hosting HTTP Server

You can host your own HTTP server instance.

Local

npm run build:server
npm run start:server
# Server runs on http://localhost:3000

Railway

1. Fork this repository
2. Connect Railway to your GitHub
3. Deploy (auto-detects configuration from railway.json)
4. Set environment variables:

• MONTHLY_REQUEST_LIMIT (default: 10000)
• ALERT_WEBHOOK_URL (optional, for notifications)

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | PORT | Server port | 3000 | | MONTHLY_REQUEST_LIMIT | Monthly request limit | 10000 | | ALERT_WEBHOOK_URL | Webhook for alerts | - | | LOG_LEVEL | Logging level | info |

Data Sources

Official API

• API: Senado Federal - Dados Abertos
• Documentation: https://legis.senado.leg.br/dadosabertos/docs/
• Format: JSON
• Authentication: None (public data)

e-Cidadania (Web Scraping)

• Website: e-Cidadania
• Content: Public consultations, legislative ideas, interactive events
• Method: HTML scraping with rate limiting (1 req/sec) and caching (15min-24h)
• Fallback: If e-Cidadania is unavailable, API tools continue working

Bill Types (Tipos de Matéria)

| Code | Name | Description | |------|------|-------------| | PEC | Proposta de Emenda à Constituição | Constitutional Amendment | | PL | Projeto de Lei | Ordinary Law Bill | | PLP | Projeto de Lei Complementar | Complementary Law Bill | | MPV | Medida Provisória | Provisional Measure | | PDL | Projeto de Decreto Legislativo | Legislative Decree Bill | | PRS | Projeto de Resolução do Senado | Senate Resolution Bill | | PLC | Projeto de Lei da Câmara | Chamber of Deputies Bill |

License

MIT

Author

Sidney da Silva Pereira Bissoli

Repository

https://github.com/SidneyBissoli/senado-br-mcp

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Changelog

1.1.0

• Added e-Cidadania integration (11 new tools)
• Web scraping infrastructure with rate limiting and caching
• Public consultations analysis (polarized/consensual)
• Legislative ideas tracking
• Interactive events monitoring
• Survey topic suggestion tool

1.0.0

• Initial release
• 22 tools for Senate data access
• Senators, bills, votes, committees, agenda, and lookup tools

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: SidneyBissoli
• Source: SidneyBissoli/senado-br-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.