# ALESP MCP > ALESP is your connection to open data from São Paulo's Legislative Assembly. Pull official records on state deputies, committee activity, and legislative proposals directly into your workflow. You can track who sponsored a bill, how much money was spent in a cabinet, or the full history of any piece of legislation. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** legislative-data, public-policy, transparency, brazil-politics, government-records, data-query ## Description Monitoring what happens at a state legislature used to be a nightmare of clicking through dusty government websites. Now, you just ask your agent. This MCP lets you pull raw data from the ALESP open portal—everything about the legislative process in São Paulo State. You can find out who's serving as a deputy, review reimbursed expenses for any cabinet, and trace the entire life cycle of a bill or proposal. It’s all structured so your AI client can query it easily. Because Vinkius hosts this MCP, you connect once to your preferred agent, and suddenly, deep government data is available in natural conversation. You don't need to learn complex API calls; you just ask for what you want—be it committee meeting minutes or the job history of staff members. ## Tools ### get_agenda_eventos Lists past and upcoming events scheduled at the Assembly. ### get_comissoes_membros Lists which deputies and staff are members of each permanent committee. ### get_comissoes_reunioes Retrieves details about specific meetings held by the permanent committees. ### get_comissoes Provides a list of all permanent committees established by the assembly. ### get_comissoes_votacoes Lists voting records and outcomes from committee sessions. ### get_deputados Retrieves a current list of all state deputies serving in the legislature. ### get_despesas_gabinetes Lists reimbursed expenses for each deputy's cabinet, with options to filter by year. ### get_documento_andamento_atual Retrieves only the current, up-to-date status of a specific legislative proposal. ### get_documento_andamento Gets the entire history and status trail of any legislative proposal or bill. ### get_documento_autor Lists all deputies and staff who authored or co-signed a particular document. ### get_funcionarios_cargos Provides the work history, or job changes, for specific ALESP staff members. ### get_legislacao_normas Lists all state laws, decrees, and resolutions that have been passed. ### get_legislacao_temas Provides a list of the general topics or themes associated with state norms. ### get_legislacao_tipo_normas Lists and categorizes different types of legal documents (e.g., law, resolution). ### get_lotacoes Shows the current work placements or assignments for ALESP staff. ### get_partidos Lists all political parties currently involved in the legislative process. ### get_proposituras_zip_url Gets a direct link to download a zip file containing every single legislative proposal. ### get_uas Lists the administrative units used by ALESP for organizational tracking. ## Prompt Examples **Prompt:** ``` List all current state deputies in ALESP. ``` **Response:** ``` I've retrieved the list of deputies. There are currently 94 active deputies. Notable members include [Name] from [Party]. Would you like to see the full list or details for a specific party? ``` **Prompt:** ``` Show me the cabinet expenses for the year 2023. ``` **Response:** ``` Fetching cabinet expenses for 2023... I have found the reimbursement records. The data includes categories like office supplies, travel, and services. Which deputy's expenses should I detail? ``` **Prompt:** ``` What are the upcoming or recent committee meetings? ``` **Response:** ``` I've accessed the committee meeting logs. Recent meetings include the 'Constitution and Justice Committee' and 'Finance and Budget'. Would you like to see the agendas or the voting results for these meetings? ``` ## Capabilities ### Track Legislative Bills Follow a proposal from its initial drafting through every status change and revision. ### Audit Deputy Finances Retrieve reimbursement records for state deputies, including historical data by year. ### Map Committee Workings Get full details on permanent committees, including their membership, past meetings, and voting outcomes. ### Identify Key Personnel List all current state deputies or check the job history and placements of assembly staff. ### Review Governance Records Access official lists for political parties, administrative units, and types of state norms (laws and decrees). ## Use Cases ### A law passed, but who wrote it? You suspect a key bill was pushed by an unexpected group. Instead of searching through dozens of documents, you ask your agent to run `get_documento_autor` on the final proposal ID. It instantly lists all co-signers and authors, giving you immediate insight into who had influence. ### Where did the money go? You are researching campaign spending patterns. You tell your agent to run `get_despesas_gabinetes` for a specific deputy over the last five years. It compiles all reimbursement records into one place, allowing you to spot unusual spikes or categories immediately. ### What is the status of this committee? You need to know if a particular topic was discussed recently. You ask about committee meetings and your agent uses `get_comissoes` combined with `get_comissoes_reunioes` to give you the latest agenda or voting results. ## Benefits - Pinpoint financial spending: Use `get_despesas_gabinetes` to check reimbursed cabinet expenses for any deputy, making it easy to compare years or identify trends. - Follow the story of a law: Get both the current status (`get_documento_andamento_atual`) and the full historical trail (`get_documento_andamento`) of a proposal instantly. - Understand governance structure: Quickly list all permanent committees (`get_comissoes`), their members (`get_comissoes_membros`), and their voting records (`get_comissoes_votacoes`). - Map staff movements: Use `get_funcionarios_cargos` or `get_lotacoes` to see where ALESP personnel are currently assigned, which is crucial for institutional analysis. - Build a political map: Get lists of all deputies (`get_deputados`) and the official political parties involved (`get_partidos`), providing instant context to any data point. ## How It Works The bottom line is: your AI client handles all the complex data calls; you just talk to it. 1. Subscribe to the ALESP MCP on Vinkius. It’s a public data source, so you won't need tricky API keys. 2. Connect your preferred AI client (like Cursor or Windsurf) and tell it what specific legislative information you need—for example, 'What were the votes for this committee last month?' 3. Your agent runs the query against the MCP, retrieving structured data on deputies, proposals, or expenses, which it then presents to you. ## Frequently Asked Questions **How do I find out who is on a permanent committee? (get_comissoes_membros)** You use `get_comissoes_membros`. This tool lists all the members assigned to specific committees, so you get an immediate roster of key players. **Can I check a deputy's spending for 2018? (get_despesas_gabinetes)** Yep. `get_despesas_gabinetes` supports historical data, so you can filter by year and pull reimbursement records for that specific period. **What's the difference between proposals? (get_documento_andamento vs get_documento_andamento_atual)** `get_documento_andamento` gives you the full life history of a proposal, while `get_documento_andamento_atual` only shows its most recent status. Use both to build a complete picture. **How do I see all state laws passed? (get_legislacao_normas)** You call `get_legislacao_normas`. It pulls the entire list of official state norms, giving you access to everything from new decrees to resolutions. **How do I check which deputies are included using get_deputados?** The list provided by get_deputados reflects all state deputies registered in the current legislative cycle. It gives you a snapshot of who is active right now, so it's crucial for real-time reporting. **If I need to see permanent committees first, should I use get_comissoes?** Yes, calling get_comissoes gives you the definitive list of all permanent standing committees. You must start here before you can check committee members or view their meeting records. **What’s the best way to download all legislative proposals at once? (get_proposituras_zip_url)** You use get_proposituras_zip_url. This tool generates a single ZIP file containing every available proposal record, making it ideal for bulk data analysis outside of your agent's direct workflow. **What is the purpose of running get_uas?** get_uas lists the Administrative Units (UAs) of ALESP. This helps you map out the organizational structure within the Assembly itself, which is useful for understanding staff placements and departments. **How can I check the reimbursed expenses for a specific deputy's cabinet?** You can use the `get_despesas_gabinetes` tool. You can also provide a specific year to retrieve historical expense data. **Is it possible to track the full history of a legislative proposal?** Yes! Use the `get_documento_andamento` tool to fetch the XML data tracking the full history and status of proposals. **How do I see who are the members of the permanent committees?** Use the `get_comissoes_membros` tool to list all members currently serving on the assembly's permanent committees.