# Campinas Open Data MCP for AI Agents AI Agent Connect

> Campinas Open Data lets you query public records from the Campinas city portal directly through your AI agent. It handles everything from searching for specific health or education datasets to pulling metadata for CSVs and PDFs. Instead of clicking through a government portal, you just ask your agent what's available.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_QQYJLqakUBduT8o6rynEsLZ3WBauAHBDbiKVbQFU/ai-agent-connect
- **Tags:** campinas, open-data, ckan, brazil, public-records

## Description

The Campinas Open Data MCP connects your AI agent directly to the public data portal for one of Brazil's major cities. If you're trying to dig into public records, you know the drill. You usually end up stuck in a loop of opening government portal tabs, scrolling through endless categories, and hoping the right CSV is actually there. This Connector changes the game by letting you just ask your agent to find specific datasets on things like health, education, or transport. It handles the searching and even pulls the metadata so you can see the data structure before you spend time downloading anything. Since this is hosted on Vinkius, you can plug it into your current workflow and get straight to the facts. It's a huge time saver for anyone who needs to pull city metrics without the manual headache of navigating a clunky web interface. Whether you're a journalist looking for a specific city metric or a developer checking a data schema, you get the info without the manual hunting.

## Tools

### list_groups
Use list_groups to see thematic categories like Education or Health. It helps you understand how the city organizes its data.

### list_organizations
Use list_organizations to see all city departments providing data. This is great for mapping out who owns which records.

### list_packages
Use list_packages to see all available dataset names. It gives you a quick overview of what's on the portal.

### search_packages
Use search_packages to find datasets matching specific criteria. It saves you from clicking through every category.

### get_package
Use get_package to get full metadata for a specific dataset. You can see the data structure before you download anything.

### search_resources
Use search_resources to find files based on specific fields. It helps you pinpoint CSVs or PDFs in large datasets.

### get_resource
Use get_resource to get metadata for a specific resource. This provides direct links and details for individual files.

### list_tags
Use list_tags to see all the tags used across the portal. It helps you identify common themes in the data.

## Prompt Examples

**Prompt:** 
```
Find datasets about public health in Campinas.
```

**Response:** 
```
I found several datasets related to health in Campinas. Here are the most relevant ones:

| Dataset Name | Last Updated | Resources |
| :--- | :--- | :--- |
| **Vagas em Creches** | June 2023 | CSV, PDF |
| **Escolas Municipais** | May 2023 | CSV |

Would you like to see the full metadata for one of these?
```

**Prompt:** 
```
List all organizations that provide data to the portal.
```

**Response:** 
```
I've retrieved the list of organizations for you. There are 25 entities in total, including:

*   **Secretaria Municipal de Saúde**
*   **Secretaria de Finanças**
*   **Secretaria de Educação**

Let me know if you'd like to see the full list or search for a specific department.
```

**Prompt:** 
```
Get full metadata for the dataset 'vagas-em-creches'.
```

**Response:** 
```
Fetching metadata for **vagas-em-creches**...

**Details:**
*   **Description:** Covers nursery school availability by region.
*   **Last Updated:** June 2023
*   **Resources:**
    *   `vagas-em-creches_data.csv`
    *   `vagas-em-creches_report.pdf`

Would you like the direct links to these files?
```

## Capabilities

### Find datasets by keyword
Search the city portal for specific topics like health or transport records.

### List all city organizations
Get a full directory of city departments that provide public data.

### Retrieve full dataset metadata
See the structure and details of a dataset before you download it.

### Browse data by thematic groups
Explore data organized by categories like Education or Finance.

### Get direct links to files
Get direct access to CSVs, PDFs, and other hosted resources.

## Use Cases

### Urban Planning Analysis
A researcher wants to find all datasets related to public transport in Campinas. They ask the agent to search for transport records and get a list of relevant links.

### Journalistic Fact Checking
A reporter needs to see which city departments provide public spending records. They ask the agent to list all organizations and filter for finance.

### Data Pipeline Development
A dev wants to check the schema of a specific CSV before writing a data pipeline. They ask the agent to get the metadata for a specific dataset.

### Public Policy Research
A student looks for education metrics across different city districts. They ask the agent to browse data by the education theme.

## Benefits

- Skip the portal navigation by finding data directly through your agent's search capabilities.
- Check data structures before downloading by viewing full metadata for any specific dataset.
- Map out city departments instantly to see who owns which records in one request.
- Find specific files like PDFs or CSVs faster by filtering based on specific field names.
- Identify relevant data themes across the city using thematic groups and tags.

## How It Works

The bottom line is you get instant access to Brazilian public records without navigating a government website.

1. Subscribe to the Connector in the Vinkius catalog.
2. Provide your Campinas Portal API Key if you need restricted access.
3. Ask your AI client for specific city data or dataset links.

## Frequently Asked Questions

**Can I use Campinas Open Data to find education records?**
Yes, you can. The Connector allows your AI agent to search specifically for education-related datasets and provide you with direct links to the records.

**Does Campinas Open Data work for other Brazilian cities?**
No, this specific MCP is built for the Campinas city portal. You would need a different MCP for other municipalities.

**How do I get links to CSV files using Campinas Open Data?**
Your AI agent can find these for you. Just ask for a specific topic, and the agent will identify the resources and provide the direct links.

**Can my agent find specific city departments with Campinas Open Data?**
Yes, it can pull a full list of all organizations and departments that provide public data through the portal.

**Is Campinas Open Data good for urban research?**
It's excellent for urban research because it gives you quick access to city-wide metrics on transport, health, and education.

**What kind of files can I find with Campinas Open Data?**
You can find various file types including CSVs for data analysis, PDFs for reports, and links to other APIs hosted on the portal.

**How can I search for datasets related to a specific topic like 'Health'?**
You can use the `search_packages` tool with a query string. For example, searching for 'saude' will return all datasets categorized under health in the Campinas portal.

**Can I see which city departments are publishing data?**
Yes! Use the `list_organizations` tool to get a complete list of all city departments and entities that contribute to the Open Data Portal.

**How do I get the download link for a specific data file?**
Use the `get_resource` tool with the specific Resource ID. It will return the metadata, including the URL to download the file (CSV, PDF, etc.).