# Paraíba Open Data MCP for AI Agents AI Agent Connect

> Paraíba Open Data MCP gives you direct access to official public spending, budget records, and payroll data from the State of Paraíba, Brazil. It lets your AI agent pull real-time government data for auditing, research, or transparency reports without you having to manually download and clean CSV files.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_KqPIVVif4yS1uOme9ViWWgDZWOuKMH1FVQPAkdJw/ai-agent-connect
- **Tags:** public-spending, transparency, budget-tracking, brazil-data, financial-auditing, open-data

## Description

Paraíba Open Data lets you pull official public spending and budget records from the State of Paraíba, Brazil. Instead of hunting through government websites or manually exporting messy spreadsheets, you can just ask your agent to find specific financial records. It handles the heavy lifting of navigating the state's public records to find budget allocations, contract details, and personnel costs. If you're looking for transparency in how state resources are spent, this tool makes that data conversational. You can use it to spot trends in government spending or pull specific payment authorizations for a deeper dive into a single department. Because it's hosted on Vinkius, you can connect it to your existing AI workflow and start querying the state's finances immediately. It turns a slow, manual research process into a few quick questions. For researchers and journalists, this means no more spending days on manual data cleaning or copy-pasting numbers from different portals. You can get a clear view of how funds move across different management units and see exactly where the money is going in real time. It removes the technical barrier between you and the public record, allowing you to focus on the actual analysis rather than the data gathering.

## Tools

### get_empenho
The get_empenho tool pulls commitment notes for state spending. This lets you see when the state formally commits to a specific expenditure.

### get_folha_pagamento
The get_folha_pagamento tool summarizes the state payroll. This is the primary way to check total personnel costs for the state government.

### get_acao_governamental
The get_acao_governamental tool pulls data on specific government actions. This helps you understand the broader context of state initiatives.

### get_autorizacao_pagamento
The get_autorizacao_pagamento tool retrieves payment authorizations from the state. This is useful for verifying that money was approved for release.

### get_contratos_aditivos
The get_contratos_aditivos tool fetches details on contract addendums. Use this to see how original agreements have changed over time.

### get_contratos
The get_contratos tool lists official government contracts. This provides a high-level view of all active agreements with the state.

### get_convenios
The get_convenios tool retrieves information on covenants and agreements. This is the best way to find partnership details between different entities.

### get_diarias
The get_diarias tool pulls data on daily allowances for public servants. This helps you track travel-related spending across the state.

### get_dotacao
The get_dotacao tool gets specific budget allocation data. Use this to see how much money is officially earmarked for specific projects.

### get_elemento_despesa
The get_elemento_despesa tool retrieves details on expense elements. This provides a granular look at how specific types of spending are categorized.

### get_fonte_recurso
The get_fonte_recurso tool identifies the source of state resources. Use this to see where the funding for a project actually comes from.

### get_funcao
The get_funcao tool retrieves data on government functions. This helps you categorize spending by the type of public service provided.

### get_liquidacao
The get_liquidacao tool pulls liquidation data for state finances. This shows when the state confirms that a service was actually rendered.

### get_modalidade_licitacao
The get_modalidade_licitacao tool shows the modality used for bidding. This is key for auditing whether the correct procurement rules were followed.

### get_receitas_execucao
The get_receitas_execucao tool pulls data on revenue execution. This shows how much money the state actually collected compared to its goals.

### get_receitas_previsao
The get_receitas_previsao tool shows revenue forecasts for the state. This helps you see what the state expects to earn in the coming periods.

### get_restos_a_pagar
The get_restos_a_pagar tool retrieves information on outstanding payables. This is useful for identifying debt or remaining obligations.

### get_subfuncao
The get_subfuncao tool pulls data on sub-functions within the budget. This allows for a very specific breakdown of spending categories.

### get_unidade_gestora
The get_unidade_gestora tool identifies the managing unit for specific funds. Use this to find out which specific department is responsible.

### get_unidade_orcamentaria
The get_unidade_orcamentaria tool retrieves information on budgetary units. This helps you see how the state organizes its financial structure.

## Prompt Examples

**Prompt:** 
```
How much did the state of Paraíba spend on daily allowances last month?
```

**Response:** 
```
### Daily Allowance Summary - January 2024

| Category | Total Amount | Notes |
| :--- | :--- | :--- |
| Administrative | R$ 45,000.00 | Standard travel for 12 units |
| Health Services | R$ 12,500.00 | Rural clinic visits |
| Education | R$ 8,200.00 | Teacher training workshops |

**Total Spent:** R$ 65,700.00

Would you like a breakdown of the specific units with the highest spending?
```

**Prompt:** 
```
Can you show me the budget allocation for the health department?
```

**Response:** 
```
**Budget Allocation: Health Department (2024)**

*   **Total Authorized:** R$ 150,000,000.00
*   **Primary Units:**
    *   Regional Clinics (40%)
    *   State Hospitals (35%)
    *   Preventative Care (25%)

I can pull the specific **get_dotacao** details for any of these sub-units if you need a deeper dive.
```

**Prompt:** 
```
What are the outstanding payables for the state right now?
```

**Response:** 
```
### Outstanding Payables (Restos a Pagar)

As of the latest report, the state has the following outstanding obligations:

*   **Public Works:** R$ 12,400,000.00
*   **Supplies & Materials:** R$ 3,200,000.00
*   **Service Contracts:** R$ 5,800,000.00

**Total Outstanding:** R$ 21,400,000.00

Do you want to see the breakdown by managing unit?
```

## Capabilities

### Query budget allocations
Use get_dotacao to see exactly how much money is earmarked for specific state projects.

### Inspect payment authorizations
Check get_autorizacao_pagamento to verify that funds were officially approved for release.

### Summarize state payroll
Get a clear view of personnel costs using get_folha_pagamento for state employees.

### Analyze government contracts
List and review official agreements using get_contratos to see active state partnerships.

### Track revenue forecasts
Compare expected income against actual spending with get_receitas_previsao.

### Identify resource sources
Find out where funding actually comes from using get_fonte_recurso for any given project.

## Use Cases

### Investigative Reporting on State Contracts
A journalist wants to see if a specific contract was overpaid. They ask the agent to list all state agreements using get_convenios.

### Audit Compliance for Public Funds
An auditor needs to see if payments match the budget. They ask the agent to pull get_dotacao and get_autorizacao_pagamento.

### Transparency Advocacy for Travel Spending
A citizen wants to know how much is spent on travel. They ask the agent to list daily allowances using get_diarias.

### Financial Forecasting for Researchers
A researcher needs to know the state's revenue trends. They ask the agent for get_receitas_previsao.

## Benefits

- Skip manual CSV downloads by using get_contratos to pull all state agreements instantly.
- Track state employee costs faster with get_folha_pagamento to see payroll summaries.
- Identify funding gaps by comparing get_receitas_execucao against actual spending.
- Verify government spending rules using get_modalidade_licitacao for bidding transparency.
- Analyze specific project funding with get_dotacao to see where the money goes.
- Monitor debt by checking get_restos_a_pagar for outstanding state payables.

## How It Works

The bottom line is you get direct, conversational access to the State of Paraíba's official financial records.

1. Subscribe to the Paraíba Open Data MCP on Vinkius.
2. Enter your API access token from the Paraíba data proxy into your AI client.
3. Ask your agent for specific state spending data like payroll summaries or contract lists.

## Frequently Asked Questions

**Can I use Paraíba Open Data MCP to find government contracts?**
Yes, this Connector lets you list and analyze official state contracts directly through your AI client. You can see active agreements and their specific details without manual searching.

**Does Paraíba Open Data MCP include payroll information?**
It provides access to payroll summaries so you can monitor state personnel costs. This is a great way to see the total gross and net values for state employees.

**Can I use Paraíba Open Data MCP for investigative journalism?**
It is an excellent tool for journalists who need to aggregate spending data for reports. It allows you to pull records quickly so you can focus on your story.

**Is the data from Paraíba Open Data MCP updated in real-time?**
The Connector connects to the official portal to provide the most current public spending and budget data available to the public.

**Can I use Paraíba Open Data MCP to check state revenue?**
Yes, you can query both revenue execution and revenue forecasts to see how the state's finances are performing compared to their goals.

**Who can use Paraíba Open Data MCP for auditing?**
Public auditors and lawyers can use it to cross-reference payment authorizations and contracts directly within their existing workspace.

**Can I see the total payroll for a specific month and year?**
Yes! Use the `get_folha_pagamento` tool by providing the `exercicio` (year) and `mes` (month). The agent will return a summary of personnel spending for that period.

**How do I check government contracts for a specific year?**
You can use the `get_contratos` tool with the `exercicio` parameter. This will list the contracts registered in the state's system for the requested year.

**Is it possible to track outstanding debts (Restos a Pagar)?**
Yes, the `get_restos_a_pagar` tool allows you to fetch data on expenses that were committed but not yet paid from previous fiscal years.