# Brasil.io MCP for AI Agents AI Agent Connect

> Brasil.io MCP lets you pull structured Brazilian public data directly into your AI agent. Skip the manual CSV downloads and government portal navigation. Query COVID-19 stats, company records, and socio-economic datasets with simple natural language prompts.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_swehodurJBOgqLG2QWdYnp1gP3aOvkPJZvrwX5yQ/ai-agent-connect
- **Tags:** brazil-data, public-datasets, open-data, transparency, statistics

## Description

This Connector connects your AI agent to Brasil.io, the primary source for accessible Brazilian public data. Instead of hunting through confusing government portals or downloading messy spreadsheets, you can just ask your agent to find specific information. It works by letting your agent browse available datasets, check what kind of information a table holds, and then pull the exact records you need using filters like state, city, or date. You'll find it's a huge time saver when you're trying to get facts for a report or a research paper. Since Vinkius hosts this Connector, you can plug it into your existing workflow and get straight to the analysis. It turns your agent into a specialist for Brazilian public records, handling the data fetching so you can focus on what the numbers actually mean. You don't have to worry about the technical side of the API or the messiness of government data formats. You just describe what you need, and the agent handles the rest. This means you can go from a vague question about public spending to a structured list of records in seconds. It removes the friction of manual data entry and gives you a direct line to the facts.

## Tools

### list_datasets
See every public dataset available on the Brasil.io platform. This helps you find the right source for your query.

### query_table_data
Pull specific records from a table using JSON filters for states, cities, or dates. It gets the exact rows you need.

### get_table_metadata
Check the columns and data types for any specific table before you run a query. It ensures your agent knows what to ask for.

## Prompt Examples

**Prompt:** 
```
What kind of Brazilian public data can I access?
```

**Response:** 
```
You can access a wide range of Brazilian public datasets through this connection, including:

* **Health Data:** COVID-19 statistics by state and city.
* **Economic Data:** Socio-economic indicators and records.
* **Public Records:** Judicial salaries and company records.

Would you like to see a list of all available datasets?
```

**Prompt:** 
```
Show me the COVID-19 stats for Curitiba in the state of Paraná.
```

**Response:** 
```
I've retrieved the latest records for Curitiba, PR. Here is the summary:

| Date | Confirmed Cases | Deaths |
| :--- | :--- | :--- |
| 2023-03-20 | 1,240 | 45 |

Would you like to see the data for a different date or a different city?
```

**Prompt:** 
```
What columns are in the 'salarios-magistrados' table?
```

**Response:** 
```
The 'salarios-magistrados' table contains the following fields:

* **id**: Unique identifier
* **nome**: Name of the magistrate
* **cargo**: Position held
* **salario**: Monthly salary
* **estado**: State

You can use these to filter the data. What would you like to search for?
```

## Capabilities

### Browse all public datasets
See every dataset available on the Brasil.io platform in one list.

### Inspect table schemas
Check specific tables to see exactly which columns and data types are available.

### Filter records by location
Narrow down results to specific Brazilian states or cities.

### Filter records by date
Retrieve historical or current data points using specific date ranges.

### Navigate large results
Move through thousands of records efficiently using built-in pagination.

## Use Cases

### Checking local health stats
A journalist asks for COVID-19 deaths in a specific city and gets a summary in seconds without opening a single government website.

### Company research
An analyst wants to find company records in a specific state and uses query_table_data to get a structured list of results.

### Academic comparison
A researcher pulls socio-economic data for five different states to compare them in a table for a thesis.

### App development
A developer uses get_table_metadata to understand the data structure before building a dashboard for Brazilian public records.

## Benefits

- Stop downloading CSVs. You can pull data directly into your chat, which saves hours of manual file handling and data cleaning.
- Precise filtering with query_table_data. You can narrow down results to a specific city or date range instantly with simple JSON filters.
- Easy data exploration. Use list_datasets to see what's available on the platform before you start your research or reporting.
- No more guessing. get_table_metadata tells you exactly what columns exist so you don't have to waste time guessing field names.
- Handle large volumes. Built-in pagination means you can move through thousands of records without crashing your session or hitting limits.

## How It Works

The bottom line is you get structured Brazilian public data without any manual scraping.

1. Get your Brasil.io API Token from their official platform.
2. Connect the Connector to your AI client through the Vinkius catalog.
3. Ask your agent to pull specific Brazilian data records or summarize stats.

## Frequently Asked Questions

**Can I use Brasil.io MCP to get COVID-19 data?**
Yes, you can pull COVID-19 statistics directly. Your agent can fetch data by state, city, and date, providing you with a clear view of the numbers without any manual downloads.

**Does Brasil.io MCP work for company records in Brazil?**
It does. You can query company records and other public datasets hosted on the platform using natural language prompts.

**How do I get Brazilian socio-economic data without downloading files?**
This Connector allows your agent to fetch that data directly. You just ask for the specific metrics or regions you need, and the agent pulls the records for you.

**Can I filter Brazilian public data by city or state?**
Yes, you can. The Connector supports filtering by various parameters, including specific Brazilian states and cities, so you get the exact data you're looking for.

**Is Brasil.io MCP good for academic research on Brazil?**
It's excellent for research. It gives you a direct line to structured public data, making it much faster to gather facts for reports or academic papers.

**Does Brasil.io MCP help with government transparency data?**
Yes, it connects to one of the leading platforms for Brazilian public data, making it easier to access information on public spending and other transparent records.

**How can I filter data for a specific state or city?**
Use the `query_table_data` tool and provide a JSON string in the `filters` parameter, such as `{"state": "SP", "city": "São Paulo"}`. The agent will apply these filters to the Brasil.io API request.

**How do I find out what columns are available in a dataset?**
First, use `list_datasets` to find the slug of the dataset. Then, use `get_table_metadata` with the dataset and table slugs to see the full list of available fields and their descriptions.

**Can I navigate through large amounts of data?**
Yes. Both `list_datasets` and `query_table_data` support `page` and `page_size` parameters, allowing you to iterate through results without overloading the response.