senado-br-mcp
About
MCP Server for Brazilian Federal Senate open data - legislators, bills, votes, committees
Details
- Author
- sidneybissoli
- Categories
- Other
Jump to
Setup
Install senado-br-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/sidneybissoli/senado-br-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
⚠️ Deprecated — this repository has moved
This server isno longer maintained here.The Brazilian Senate MCP server now lives atsenado-br-mcp-cloudflare—66 toolswith level-1provenance, available bothhosted(https://senado.sidneybissoli.com/mcp, no setup) and vianpm/stdio(npx senado-br-mcp, v3.x). The npm packagesenado-br-mcpnow publishes that server(v3.2.1+); versions< 3.0.0here are deprecated. Please migrate — this repository is archived.
MCP server for Brazilian Federal Senate open data (legislators, bills, votes, committees).
Servidor MCP (Model Context Protocol) que permite acesso estruturado aos dados abertos do Senado Federal do Brasil, democratizando o acesso a informações legislativas através de conversas com IA.
Ask your assistant, in plain Portuguese:
- "Liste os senadores de SP em exercício."→senado_listar_senadores
- "Mostre a tramitação da PEC 45/2019."→senado_buscar_materias+senado_obter_materia
- "Quais ideias legislativas mais apoiadas estão abertas no e-Cidadania?"→senado_ecidadania_listar_ideias
The answers come live from the Senate's official open-data APIs — real data with provenance, not numbers guessed from training data.
- 33 toolsfor accessing Senate data
- Real-time data from official API
- e-Cidadania integration: citizen participation data via web scraping
- Structured JSON responses
- Error handling with actionable suggestions
- TypeScript with full type safety
- Two access modes:stdio (npm) and HTTP remote
Both modes provide access to the same 33 tools.
npm install -g senado-br-mcp senado-br-mcp
git clone https://github.com/SidneyBissoli/senado-br-mcp.git cd senado-br-mcp npm install npm run build npm start
Add to yourclaude_desktop_config.json:
Windows:%APPDATA%\Claude\claude_desktop_config.jsonmacOS:~/Library/Application Support/Claude/claude_desktop_config.json
{ "mcpServers": { "senado-br-mcp": { "command": "npx", "args": ["-y", "senado-br-mcp"] } } }
No installation required. Connect directly via URL.
In Claude Desktop settings, go to"Add Custom Connector"and enter:
- Name:senado-br-mcp
- URL:https://senado-br-mcp.up.railway.app/mcp
The HTTP server has a monthly request limit to stay within free tier:
- Alerts are sent at 50%, 80%, and 100% usage
- When limit is reached, use the npm version instead
- Limit resets on the 1st of each month
Tools for accessing e-Cidadania data - the Senate's citizen participation platform.
Public Consultations (Consultas Públicas)
Interactive Events (Eventos Interativos)
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.
Use senado_listar_senadores with uf: "SP"
Search for Constitutional Amendments in 2024
Use senado_buscar_materias with sigla: "PEC", ano: 2024
Use senado_votacoes_recentes with dias: 7
Use senado_buscar_senador_por_nome with nome: "Randolfe"
Use senado_membros_comissao with sigla: "CCJ"
Use senado_ecidadania_consultas_polarizadas with minimoVotos: 5000
Use senado_ecidadania_ideias_populares with limite: 5
Use senado_ecidadania_listar_eventos with status: "agendado"
All tools return structured JSON responses:
{ "success": true, "data": { ... }, "metadata": { "fonte": "Senado Federal - Dados Abertos", "dataConsulta": "2024-01-15T10:30:00Z", "endpoint": "/senador/lista/atual" } }
{ "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" } }
# Build stdio version (npm package) npm run build # Build HTTP server version npm run build:server # Build both npm run build:all
# stdio mode npm run dev # HTTP server mode npm run dev:server
You can host your own HTTP server instance.
npm run build:server npm run start:server # Server runs on http://localhost:3000
- Fork this repository
- Connect Railway to your GitHub
- Deploy (auto-detects configuration fromrailway.json)
- Set environment variables:
- MONTHLY_REQUEST_LIMIT(default: 10000)
- ALERT_WEBHOOK_URL(optional, for notifications)
- API:Senado Federal - Dados Abertos
- Documentation:https://legis.senado.leg.br/dadosabertos/docs/
- Format: JSON
- Authentication: None (public data)
https://github.com/SidneyBissoli/senado-br-mcp
Contributions are welcome! Please feel free to submit a Pull Request.
- 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
- Initial release
- 22 tools for Senate data access
- Senators, bills, votes, committees, agenda, and lookup tools
AI-powered property zoning, buildability, and ADU eligibility analysis for any U.S. address via 20+ government data sources.
Search NHTSA vehicle recalls and FDA food/drug recalls in real-time. 4 MCP tools for product safet monitoring.
A Centralized MCP Server for Fetching Data from Many Countries' Govs
Search U.S. government contracts, vendors, and awards.
Full access to searches tenders, companies, governement spendings and procurement data from Indonesia
jpcite — Japan public-program MCP server. 11,684 subsidies + 9,484 e-Gov laws + 22,258 enforcement cases + 13,801 invoice registrants + 166K corporate entities. 93 tools. Evidence Packet with source_url + fetched_at + known gaps. ¥3/req metered, 3 free per IP daily. Anonymous trial, no signup.
Institutional research and manager diligence reports on hedge funds, venture capital and private equity managers. Summary of filings, personnel changes, media screening and social signals delivered to you in minutes.
Deep fundamental data from SEC filings, including operational KPIs not found on Bloomberg, built for your financial AI agents.
Control anaerobic digestion modeling (ADM1) using natural language.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
