# Campinas Open Data MCP for AI Agents AI Agent Connect

> Campinas Open Data lets you query public datasets from Campinas, Brazil, directly through your AI agent. It handles everything from searching for specific city records to retrieving metadata for CSVs and PDFs. Use it to find health, education, or transport data without browsing through complex government portals. It's built to give you immediate access to city records, making it a go-to for urban research and public policy analysis.

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

## Description

Searching for public records in Brazil usually involves navigating dense government portals and digging through nested menus. This Connector changes that by bringing the Campinas Open Data Portal directly into your workspace. Instead of hunting for specific files on a website, you just ask your agent to find what you need. It can pull up specific datasets on city transport, education, or public health based on your keywords. If you need to know the technical structure of a file before you start your analysis, it grabs the metadata for you. It even helps you map out which city departments are responsible for which datasets. It's one of the many specialized connectors available in the Vinkius catalog that makes navigating local government data a lot less of a headache. You get direct links to the actual files, like CSVs or PDFs, so you can move straight into your work. For a journalist looking into public spending, this means skipping the "where do I click" phase and jumping straight to the facts. For a researcher studying urban mobility, it means finding the exact schema for transport routes in seconds. It removes the friction of manual searching and lets you focus on what the data actually tells you.

## Tools

### list_groups
g., Education, Health).

List thematic groups

### list_organizations
List organizations providing data

### list_packages
List all dataset names

### search_packages
Search for datasets matching specific criteria

### get_package
Get full metadata for a specific dataset

### search_resources
g., name:financeiro).

Search for resources based on fields

### get_resource
Get metadata for a specific resource

### list_tags
List all tags used across the portal

## Prompt Examples

**Prompt:** 
```
Search for datasets about 'educação' in Campinas.
```

**Response:** 
```
I found several datasets related to education in Campinas. Here are the top results:

| Dataset Name | Description | Resources |
| :--- | :--- | :--- |
| **Vagas em Creches** | Nursery school availability | CSV, PDF |
| **Escolas Municipais** | List of municipal schools | CSV |

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

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

**Response:** 
```
I've retrieved the list of organizations providing data to the Campinas Open Data Portal. There are 25 entities, including:

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

Let me know if you want 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**...

This dataset includes **3 resources** (CSV and PDF) and was last updated in **June 2023**. It covers nursery school availability by region and includes the following fields:
- Region Name
- Number of Vacancies
- Capacity
- Update Timestamp
```

## Capabilities

### Search city datasets
Find specific records on health, education, or finance using keywords.

### Pull file metadata
Get the technical structure and details of a dataset before you download it.

### Map city departments
See which government organizations provide specific types of public data.

### Browse data themes
Explore records by category like education or public health.

### Get direct file links
Retrieve direct paths to CSVs, PDFs, and other hosted resources.

## Use Cases

### Finding school locations for urban planning
A city planner asks the agent to find all school records in a specific district. The agent uses campinas_search_packages to find the data and provides the direct links.

### Investigating public spending for a news story
A journalist asks for all datasets related to financeiro. The agent uses campinas_list_groups and campinas_search_packages to pull the relevant records.

### Checking API schemas for a dev project
A developer wants to see the structure of a city transport file. The agent uses campinas_get_package to show the metadata without downloading the whole file.

### Pulling regional health metrics for a study
A researcher asks for health data in Campinas. The agent uses campinas_search_resources to find the specific CSV files for analysis.

## Benefits

- Skip the manual portal browsing by using campinas_search_packages to find records instantly.
- Get technical details quickly with campinas_get_package to see data structures before you start.
- Map out city governance using campinas_list_organizations to see who owns which data.
- Find specific files like PDFs or CSVs faster with campinas_search_resources.
- Organize your research by browsing themes with campinas_list_groups.

## How It Works

The bottom line is you get direct access to Brazilian city records without leaving your chat interface.

1. Connect the Campinas Open Data MCP to your AI client.
2. Enter your API key if you need to access restricted records.
3. Ask your agent to find specific city data or file links.

## Frequently Asked Questions

**Can Campinas Open Data find health records?**
Yes, the Connector can search for specific public health datasets within the Campinas portal. You can ask your agent to find records related to hospitals, clinics, or regional health metrics.

**Does Campinas Open Data work for other Brazilian cities?**
No, this Connector is specifically designed to connect to the Campinas Open Data Portal. For other cities, you would need a different connector.

**How do I get CSV files from Campinas Open Data?**
Your agent can find the direct download links for CSV files. Just ask it to search for a specific topic, and it will provide the links to the resources.

**Can I see which departments own the data with Campinas Open Data?**
Yes, the Connector can list all the city organizations that provide data. This helps you identify which government branch manages the records you are looking for.

**Is an API key required for Campinas Open Data?**
An API key is optional for public data. However, if you need to access restricted records, you can provide your Campinas Portal API key in your settings.

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