Senado Federal MCP for AI. Track Brazilian bills from introduction to vote.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Senado Federal MCP Server connects your AI agent directly to the Brazilian Senate Open Data API. It lets you track legislative proposals (matérias), check senator profiles, map committee compositions, and analyze the full history of votes and mandates in one go.
Need to know where a bill stands? This is it.
What your AI can do
Get comissao composicao
Lists all current members who serve on a specified Senate committee.
Get comissao
Retrieves detailed information for one specific committee by its ID.
Get legislatura atual
Provides key information about the current, ongoing legislative term in Brazil.
You track a specific legislative proposal by getting its details and then querying its movement history across various committees.
You pull a senator's full record, including their party shifts (mandate analysis) and all the official positions they’ve held throughout their career.
You pinpoint exactly which senators are assigned as rapporteurs for a bill or list every member currently serving on any Senate committee.
You retrieve details about specific legislative periods (legislatures) to understand how lawmaking has evolved over time in Brazil.
You list upcoming or past committee meetings and general Senate sessions so you know when the action is happening.
Ask an AI about this
Waiting for input…
Senado Federal MCP Server: 21 Tools for Legislative Data Access
These tools give your AI agent direct access to the Brazilian Senate's database. Use them together to track bills, analyze profiles, and map procedural history.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Senado Federal on VinkiusGet Comissao Composicao
Lists all current members who serve on a specified Senate committee.
Get Comissao
Retrieves detailed information for one specific committee by its ID.
Get Legislatura Atual
Provides key information about the current, ongoing legislative term in Brazil.
Get Legislatura
Pulls the full details for one specific historical or active legislative period.
Get Materia Movimentacoes
Lists the complete, step-by-step action history (movements) taken on a given bill.
Get Materia Relatorias
Identifies which senators are assigned to act as rapporteurs for a specific proposal.
Get Materia
Gets core data and a summary for one specific legislative proposal ID.
Get Senador Cargos
Lists all official positions (roles) held by a specific senator throughout their...
Get Senador Filiacoes
Shows the political party affiliations and changes for a given senator ID.
Get Senador Mandatos
Retrieves the full history of mandates (terms) held by any parliamentarian.
Get Senador
Retrieves comprehensive profile data for any single senator, including their current...
Get Votacao
Gets specific details about a single vote, including who voted how.
List Agenda Reuniao
Lists the upcoming or scheduled meetings for specific Senate committees.
List Agenda Sessao
Provides a list of all planned general committee and plenary sessions.
List Comissoes
Retrieves a directory listing of every Senate committee that exists.
List Legislaturas
Lists all historical and active legislative periods in Brazil for context.
List Materias Atualizacoes
Provides a feed of the most recently updated or moved legislative proposals.
List Materias Tipos
Returns a list defining the different types of legislation (PL, PEC, etc.) used in Brazil.
List Senadores Afastados
Lists names and details of senators who are currently on leave or suspended from service.
List Senadores Atual
Provides a list of all senators who are currently registered and active in office.
List Votacoes
Retrieves a summary listing of recent votes that occurred in the Senate.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Senado Federal integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Senado Federal, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Senado Federal. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 21 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Tracking legislative status shouldn't require 20 tabs open and three hours of cross-referencing.
Today, finding a bill’s true status means bouncing between the main Senate site, committee rosters, and historical archives. You copy an ID from one place, paste it into another to check its movement log, then maybe you need to find out who was assigned as rapporteur—it's manual data assembly, and every click is a potential point of failure.
With this MCP server, your agent handles the whole sequence. Start with `get_materia` to get the basics. Then, run `get_materia_movimentacoes`. You immediately see the full audit trail—the committee it passed through, who signed off on it, and if there's a record of a vote (which you can check using `list_votacoes`).
Senado Federal MCP Server: Get senator mandate history instantly.
Before, checking a politician’s career meant digging into multiple archives to piece together every term and party shift. You'd find one list of mandates, then another listing their roles, forcing you to manually cross-reference the dates and affiliations.
Now, running `get_senador_mandatos` followed by `get_senador_filiacoes` gives you that complete record in two steps. It’s a clean, verifiable timeline of every role they've held—a crucial piece of context for any analysis.
What your AI can actually do with this
This server connects your AI agent right into the Brazilian Senate’s Open Data API. You're not just getting a data dump; you're getting the full mechanism for tracking how laws are made and who runs this place. It lets you deep-dive into any legislative topic, map out an entire senator's career, or track exactly where a bill stands through every committee and vote.
Tracking Legislative Proposals
You wanna know what happened to a specific piece of legislation? You start by grabbing the core data for that proposal using get_materia. That gives you the basics. Then, when you need to see its full journey—every single step it took—you run get_materia_movimentacoes, and you get a complete timeline of actions taken on the bill.
To keep tabs on what’s new in Congress, use list_materias_atualizacoes for a feed of recently moved or updated proposals; you'll always know where the action is.
The process also requires knowing the rules of the game. You can check out list_materias_tipos, which tells you the different kinds of legislation used in Brazil, like PL or PEC. If that bill needs a champion, you run get_materia_relatorias to pinpoint exactly which senators are assigned as rapporteurs for it.
To see how lawmaking has worked over time, you can use list_legislaturas to get a directory of all historical and active legislative periods in Brazil; then you drill down further with get_legislatura or grab the details on the current term using get_legislatura_atual. You'll also find the core mechanisms for tracking votes.
Start by calling list_votacoes for a summary list of recent votes, and if you need to know exactly who voted what, use get_votacao to get specific details about a single vote’s participation.
Mapping Committee Work and Sessions
If you're focused on the committee level, there are dedicated tools for you. You can run list_comissoes to pull up a directory listing of every Senate committee that exists. Once you know which committee it is, you use get_comissao to retrieve detailed information about it. To see who's actually serving on that group, you call get_comissao_composicao.
You can also check out the meeting schedule: run list_agenda_reuniao for upcoming or past committee meetings, and use list_agenda_sessao to get a list of all planned general committee or plenary sessions so you know when the Senate is convening.
Deep-Dive Senator Profiles
This server lets you build out a full profile on any senator. You can start by getting comprehensive data for any single member using get_senador, which gives you their current status and party details. But that’s just scratching the surface. If you need to understand a politician's history, you run get_senador_mandatos to retrieve their full record of mandates—every term they've held.
You can also track shifts in political allegiance by calling get_senador_filiacoes, which shows all their party affiliations and any changes over time. To see the whole sweep of a career, use get_senador_cargos to list every official position or role that senator has held throughout their life.
For current roster checks, you'll find two tools: run list_senadores_atual for an active list of all senators currently registered and in office. If a senator is out of commission, use list_senadores_afastados to get their names and details, letting you know who’s on leave or suspended from service.
019e38ea-3bc6-7145-831e-0a47df2e9403 
Here's how it actually works
The bottom line is: your agent connects the dots between bills, people, and legislative events using specific IDs.
Start by calling list_materias_atualizacoes to find a recent bill ID. Then, use that ID with get_materia to get the proposal's core details.
Next, if you need to know how it moved through Congress, call get_materia_movimentacoes. This gives you the timeline of actions and votes related to that specific bill.
Finally, use get_senador or get_senador_filiacoes on a key player's ID. You get their full profile and history—everything from their first mandate to today.
Who is this actually for?
Journalists who need to verify a senator's past claims before running a story. Legal professionals tracking regulatory changes that impact their clients. Researchers mapping political influence or following the procedural history of controversial bills.
They run get_senador_mandatos to check a subject's entire career timeline, cross-referencing it with proposals tracked via get_materia_movimentacoes.
They monitor specific committees using list_comissoes and then track relevant bills through the process to see if they pass critical thresholds for implementation.
They pull data across different periods of time (get_legislatura) to model how Brazilian law has changed over decades, using list_legislaturas as a starting point.
What Changes When You Connect
See a senator's entire political arc: Instead of just checking their current party, use get_senador_mandatos and get_senador_filiacoes together. You get the full story—when they switched parties and why.
Know who has the power on a bill: Don't waste time guessing who leads a discussion. Use get_materia_relatorias to instantly see which senators are assigned as rapporteurs for any proposal ID.
Follow the lawmaking timeline: By listing all legislatives via list_legislaturas, you can compare how laws were passed ten years ago versus today, giving deep context that surface data misses.
Stay on schedule: Never miss a key hearing. Use list_agenda_reuniao and list_agenda_sessao to map out the entire week's procedural calendar for committees and plenary sessions.
Process complex bills fast: Instead of checking one proposal, use get_materia_movimentacoes. You get a full log of every action taken—from committee assignment to final voting status.
See it in action
A Journalist Verifying Claims
A journalist needs to check if Senator X really supported Policy Y five years ago. They run get_senador for Senator X, then follow up with get_materia_movimentacoes on the relevant bill ID. The agent confirms not only that they were present but also what specific actions (like voting yes/no) they took, solving the historical verification problem.
A Legal Team Tracking Policy Changes
A legal team needs to know if a proposed change affects their industry. They start by calling list_comissoes to identify relevant committees (e.g., Finance). Then they use get_materia_relatorias on proposals within that committee, ensuring nothing critical slips through the cracks before it becomes law.
Academic Researching Political Shifts
A researcher wants to model political power. They pull a list of all active senators using list_senadores_atual, and then use get_senador_filiacoes on each one to map out the current partisan breakdown, allowing for quantitative analysis across multiple cohorts.
Monitoring Urgent Legislation
An activist needs real-time status on a controversial bill. They use list_materias_atualizacoes to find the latest ID, then run get_materia_movimentacoes. This gives them an instant, definitive update on whether the bill advanced or stalled in Congress.
The honest tradeoffs
Asking for a 'Summary' of a Bill
Writing: 'Give me all the info about this bill.' The AI responds with vague bullet points that don’t cite sources or track specific procedural steps.
Don't ask for a summary. Ask the agent to run get_materia first, and then follow up by running get_materia_movimentacoes using the ID received from the first call. This forces the system to provide actionable, step-by-step data.
Checking Committee Membership Blindly
Asking: 'Who is on that committee?' The agent might only give a partial or outdated list because it doesn't know the current roster.
Always use list_comissoes first to confirm the committee name, and then specifically call get_comissao_composicao. This ensures you get the most up-to-date personnel list for that body.
Treating Data as Static
Assuming a senator's party affiliation from an old news article, or relying on general search results.
Always use get_senador_filiacoes and get_materia_movimentacoes. The data is live; it shows the current, verified status against official records.
When It Fits, When It Doesn't
Use this server if your work depends on verifiable procedural history: If you need to know when a vote happened, who was in charge of reviewing a bill (rapporteur), or exactly which committee is handling it right now.
Don't use it if you just need general background info. For example, if you only need to know the name of a law and don't care about its current status, searching an external database might suffice. But if that bill has passed through committees or requires tracking against a specific mandate history, this server is non-negotiable. If your question involves 'the sequence,' 'the role,' or 'the date,' you need the tools here.
Questions you might have
How do I find out who is currently leading the discussion on a specific bill using get_materia_relatorias? +
You pass the proposal ID to get_materia_relatorias. This tool immediately returns the names and IDs of all senators assigned as rapporteurs for that exact piece of legislation.
What is the difference between list_comissoes and get_comissao_composicao? +
list_comissoes gives you a directory of every committee name. You then use get_comissao_composicao with that specific committee's ID to pull the current roster of members.
Can I track a bill’s history and its votes using get_materia_movimentacoes? +
Yes. get_materia_movimentacoes provides the timeline, and if a vote occurred during that movement, you can cross-reference it with data from list_votacoes for more details.
How do I list all current senators in office? Use list_senadores_atual. +
Simply call list_senadores_atual. This gives you the most up-to-date directory of every senator who is actively registered and serving their mandate right now.
What if I need to check a historical legislative period? Should I use get_legislatura? +
Use get_legislatura and pass the specific ID. This allows you to pull data relevant only to that time frame, isolating it from the current activity.
What information does get_senador provide when I need detailed background data on one parliamentarian? +
It retrieves comprehensive metadata for a specific senator's ID. This includes their full profile, recorded party affiliations, and history of political roles held.
If I want to know which proposals have changed recently, should I use list_materias_atualizacoes? +
Yes, this tool tracks the most recent updates across all legislative proposals. It provides a feed of IDs and change timestamps so you can focus your analysis on fresh data.
Which function should I use to view the schedule for an upcoming committee meeting? +
You need to use list_agenda_reuniao. This function pulls specific details—date, time, and agenda items—for a particular committee, making it useful for logistics planning.
Can I see the history of actions and movements for a specific legislative proposal? +
Yes! Use the get_materia_movimentacoes tool with the Proposal ID (CodigoMateria). It will return the full chronological list of actions taken on that bill.
How do I find out which senators are currently on leave? +
Simply run the list_senadores_afastados tool. It retrieves the list of Brazilian senators who are currently not in active office due to leave.
Is it possible to check the historical positions held by a senator? +
Yes, use the get_senador_cargos tool with the Senator ID. It provides a detailed list of current and past positions held within the Senate and other bodies.
We've already built the connector for Senado Federal. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 21 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.