mcp-senado

MCP Senado Federal is an open-source MCP server that exposes the Brazilian Federal Senate's open data API as a set of tools that AI assistants can consume. It provides access to senators, legislative proposals, voting records, commissions, sessions and more through a curated suite of 56 tools organized into categories like Dados de Referência, Senadores, Propostas Legislativas, Votações, Comissões, Partidos and Sessões Plenárias. You can integrate this server with Claude, Cursor, Windsurf, Continue.dev and other MCP-enabled clients to query data using natural language prompts or structured requests. To use it, deploy the server and configure your MCP client to point at the provided npm package (for example via npx) so that your assistant can call the available tools such as senadores_listar, senator_detalhes, votacoes, pautas, and many others for precise data retrieval. The tools are designed to be strict and typed, returning official legislative data with input validation and error handling. For best results, combine multiple tools to build richer queries, like listing senators by state and filtering by a specific legislative term, or fetching a proposal and its voting history.

Prerequisites:

• Node.js 18.x or higher
• npm 9.x or higher
• Sufficient memory (at least 512MB RAM)
• Supported OS: Linux, macOS, Windows (WSL2)

Installation options:

1. Install and run via npx (recommended for quick start)

# Install globally and run directly via npx
npm install -g @aredes.me/mcp-senado
npx @aredes.me/mcp-senado

2. Install from Git repository (development workflow)

git clone https://github.com/cristianoaredes/mcp-senado.git
cd mcp-senado
npm install
npm run build
npm start

3. Run via Docker (if you prefer containerized deployment)

# Example docker command (adjust image as needed)
docker run -it --rm -p 8080:8080 ghcr.io/aredes/me/mcp-senado:latest

Note: The README indicates the npm-based workflow is the recommended path, with the mcp server accessible as @aredes.me/mcp-senado.

Tips and common considerations:

• You can configure the MCP client (Claude Desktop, Cursor, Windsurf, Continue.dev) to use the npx command with the package name @aredes.me/mcp-senado, as shown in the quick start examples.
• The MCP configuration supports an optional environment variable MCP_LOG_LEVEL; set it to info or debug to increase verbosity for troubleshooting.
• Ensure Node.js 18+ and npm 9+ are installed on the deployment host. Hardware requirements are modest but provide enough RAM for caching and rate limiting.
• The server is designed to work with Docker, Cloudflare Workers, and HTTP/REST deployments; choose the deployment method that best fits your needs.
• When using the MCP tools, you’ll access a comprehensive set of endpoints under the 56 tools categorized by data domain (e.g., senators, votes, proposals). Use the documentation to understand each tool’s filters and return structure.
• If you encounter network or API rate limits, consider enabling the built-in rate limiting and cache features described in the documentation, and adjust MCP client timeouts accordingly.