# ALESP MCP for AI Agents AI Agent Connect

> ALESP MCP provides direct access to the open data portal of the Legislative Assembly of São Paulo. It lets your AI agent pull official records on state deputies, cabinet expenses, legislative proposals, and committee activities from the state's public registry.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_l914bfrKjPeyO0ferfmDw6IzToy5rH92WD4JePbL/ai-agent-connect
- **Tags:** legislative-data, public-policy, transparency, brazil-politics, government-records, data-query

## Description

You can now query the official records of the São Paulo State Legislative Assembly without hunting through nested government portals. This Connector connects your AI client to the state's open data feed, making it easy to pull specific information about state deputies, their political parties, and their cabinet spending. Instead of manually searching for individual bills, you can ask your agent to find the full history of a specific proposal or see who authored it. It also gives you a clear view of committee meetings, voting records, and the organizational structure of the assembly. If you're looking for financial transparency, you can pull reimbursement data for any deputy to see exactly how funds are being spent. Because Vinkius hosts this connection, you don't have to worry about complex API keys or technical hurdles. You just get the data you need in a clean format that your agent can process immediately.

## Tools

### get_agenda_eventos
List upcoming and past events scheduled at the Assembly. This helps you keep track of the legislative calendar.

### get_comissoes_membros
List members of the permanent committees. Use this to see who sits on specific legislative bodies.

### get_comissoes_reunioes
List meetings of the permanent committees. This shows you when and where specific committee sessions occur.

### get_comissoes
List permanent committees of the assembly. Use this to see the full list of active legislative committees.

### get_comissoes_votacoes
List votes of the permanent committees. This provides a record of how specific committees voted on issues.

### get_deputados
List all state deputies in the current legislature. This gives you a complete roster of current state representatives.

### get_despesas_gabinetes
List reimbursed expenses for each deputy cabinet. You can also provide a year to pull historical financial data.

### get_documento_andamento_atual
Get current status of proposals. This is useful for checking where a specific bill stands in the process right now.

### get_documento_andamento
Get full history and status of proposals. Use this to see every step a legislative document has taken.

### get_documento_autor
List authors and co-signers for each legislative document. This identifies who is actually driving specific legislation.

### get_funcionarios_cargos
List job history of ALESP staff. This helps in auditing the professional background of assembly employees.

### get_legislacao_normas
List state norms such as laws, decrees, and resolutions. This provides a list of all active state regulations.

### get_partidos
List political parties participating in the legislative process. This gives you an overview of the political landscape.

### get_legislacao_temas
List themes and topics of state norms. Use this to find legislation related to specific subjects like health or education.

### get_legislacao_tipo_normas
List types of state norms. This helps you filter between different categories of state legal documents.

### get_lotacoes
List current placements of ALESP staff. Use this to see where specific employees are currently assigned.

### get_proposituras_zip_url
Get the URL for the comprehensive list of all legislative proposals in a ZIP file. This is great for bulk data downloads.

### get_uas
List Administrative Units of ALESP. This shows the internal organizational structure of the assembly.

## Prompt Examples

**Prompt:** 
```
Who are the current state deputies in the São Paulo assembly?
```

**Response:** 
```
I've pulled the list of current state deputies for you. There are currently 94 active deputies in the legislature. 

**Key Highlights:**
* **Total Count:** 94
* **Parties Represented:** [List of major parties]

Would you like me to list them by political party or show you the details for a specific deputy?
```

**Prompt:** 
```
Can you show me the cabinet expenses for the year 2023?
```

**Response:** 
```
I've accessed the reimbursement records for 2023. Here is a summary of the spending categories:

| Category | Description |
| :--- | :--- |
| **Office Supplies** | Materials for cabinet operations |
| **Travel** | Reimbursed costs for official trips |
| **Services** | Outsourced administrative costs |

Which deputy would you like me to detail first?
```

**Prompt:** 
```
What is the current status of the new education bill?
```

**Response:** 
```
I've checked the current status of the education proposal. 

**Current Status:** In Committee Review
**Last Update:** [Date]
**Key Info:**
* **Author:** [Name]
* **Current Committee:** Education and Culture

Would you like to see the full history of this bill or the names of the co-signers?
```

## Capabilities

### Track deputy affiliations
Get a list of all current state deputies and their political parties.

### Audit cabinet spending
Pull historical and current reimbursement records for any deputy's cabinet.

### Monitor bill progress
See the full history and current status of any legislative proposal.

### Review committee activity
Access meeting logs and voting records for permanent committees.

### Inspect staff records
View job history and current placements for assembly staff members.

## Use Cases

### Tracking campaign spending
A journalist asks the agent to pull cabinet expenses for a specific deputy from 2023. The agent uses get_despesas_gabinetes to find the data.

### Monitoring bill progress
A legal researcher wants to know where a new education bill stands. The agent uses get_documento_andamento_atual to check the current status.

### Researching committee votes
An activist wants to see how a specific committee voted on a resolution. The agent pulls the records using get_comissoes_votacoes.

### Auditing staff placements
A transparency group asks for the current placement of assembly staff. The agent uses get_lotacoes to provide the full list.

## Benefits

- Audit deputy spending instantly using get_despesas_gabinetes to see how cabinet funds are spent over multiple years.
- Track the lifecycle of any bill with get_documento_andamento to see every milestone from authoring to final approval.
- Identify key political players quickly by pulling the full roster of state representatives with get_deputados.
- Monitor committee activity and voting history using get_comissoes_votacoes to see how specific groups influence policy.
- Research state regulations by searching for specific topics using get_legislacao_temas instead of manual keyword searching.
- Verify the professional background of assembly staff using get_funcionarios_cargos for accurate public oversight.

## How It Works

The bottom line is you get direct access to São Paulo legislative data without the manual searching.

1. Subscribe to the ALESP MCP on the Vinkius platform.
2. Connect the Connector to your preferred AI client like Claude or Cursor.
3. Ask your agent to pull specific legislative data or financial records.

## Frequently Asked Questions

**What kind of data can the ALESP MCP actually access?**
This Connector connects you to the official open data portal of the São Paulo State Legislative Assembly. You can get information on state deputies, their cabinet spending, legislative proposals, and committee meeting records.

**Can I use the ALESP MCP to find out how much money deputies are spending?**
Yes. You can ask your agent to pull reimbursement records for any specific deputy cabinet. It can even show you historical spending data from previous years.

**How does the ALESP MCP help with legislative research?**
It allows you to track the entire lifecycle of a bill. You can see who authored a proposal, who co-signed it, and every step it has taken through the various committees.

**Is the data from the ALESP MCP up to date?**
Yes, the Connector connects to the official state portal, which provides real-time updates on legislative activities, committee meetings, and current deputy information.

**Can I use the ALESP MCP for federal Brazilian laws?**
No, this Connector is specifically for the state-level Legislative Assembly of São Paulo. For federal laws and national data, you would need a different connector.

**Does the ALESP MCP require any special API keys?**
No, because this is a public data source, you don't need to manage complex keys. You just connect it through Vinkius and start asking questions.

**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.