# ANEEL Dados Abertos MCP for AI Agents AI Agent Connect

> ANEEL Dados Abertos MCP. Access the Brazilian National Electric Energy Agency (ANEEL) Open Data Portal to query electricity sector datasets, resources, and records.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_qkOU1jWvqE7yxGcO1CTAk4eAbZuZjaK0AmjdfI02/ai-agent-connect
- **Tags:** electricity, brazil, energy-data, public-records, aneel

## Description

This Connector connects your AI agent to the Brazilian National Electric Energy Agency (ANEEL) Open Data Portal. You can explore the electricity market through a simple conversation rather than clicking through endless web pages. When you add this Connector to your setup via Vinkius, your agent gains the ability to discover every public dataset, inspect metadata, and grab specific file links. It handles the heavy lifting of navigating the ANEEL DataStore API so you can focus on the analysis. You can find specific electricity tariffs, generation metrics, and distribution records without ever leaving your chat interface.

## Tools

### get_package
Get full metadata for a specific ANEEL dataset. This helps you understand what data is included before you start your analysis.

### get_resource
Get metadata for a specific ANEEL resource. This provides the download URL and format for CSV, PDF, or XLS files.

### list_packages
List all dataset names in the ANEEL portal. Use this to see the full range of available electricity information.

### search_datastore
Search for records within an ANEEL resource. This allows you to find specific entries like regional tariffs or operational stats.

## Prompt Examples

**Prompt:** 
```
What datasets are available for distributed generation in Brazil?
```

**Response:** 
```
I've checked the ANEEL portal for you. Here are the relevant packages:

* **geracao-distribuida**
* **tarifas-distribuidoras**
* **interrupcoes-energia**

Would you like me to pull the metadata for any of these?
```

**Prompt:** 
```
Show me the download links for the 'tarifas-distribuidoras' package.
```

**Response:** 
```
The 'tarifas-distribuidoras' package contains the following resources:

| Resource Type | Format | Download URL |
| :--- | :--- | :--- |
| Current Rates | CSV | [Download Link] |
| Manual | PDF | [Download Link] |
| Historical Data | XLS | [Download Link] |
```

**Prompt:** 
```
Find records for 'ENEL' in the distribution tariffs.
```

**Response:** 
```
Searching the ANEEL DataStore for 'ENEL' within the distribution tariffs records...

I found 15 records. The most recent entries show:
* **Tariff Adjustments**: 2.4% increase in the São Paulo region.
* **Operational Metrics**: 98.5% uptime reported for the last quarter.
```

## Capabilities

### List all electricity packages
See every available dataset in the Brazilian energy portal at once.

### Fetch package metadata
Get detailed information about specific datasets including tags and organizations.

### Retrieve file download URLs
Get direct links to CSV, PDF, and XLS files within a dataset.

### Search records within CSVs
Query specific entries inside integrated resources for faster data discovery.

### Filter energy records by provider
Find specific data points for regional electricity providers and metrics.

## Use Cases

### Tariff Analysis
A consultant asks for 'São Paulo distribution rates' and gets a table of values from the distribution tariffs package.

### Market Research
An analyst wants to know all datasets related to 'distributed generation' and uses the list tool to see the full scope.

### Data Migration
A developer needs to find all CSV resources for a specific package to build an energy dashboard.

### Regulatory Audit
A compliance officer looks for specific operational metrics for a regional provider using the search tool.

## Benefits

- Stop manual portal navigation. Use list_packages to see everything available in one go to find your specific data faster.
- Get direct file access. Use get_resource to grab download links for CSVs and PDFs instantly without hunting through web directories.
- Query specific records. Use search_datastore to find provider-specific data like regional tariffs without manual filtering or sorting.
- Understand dataset context. Use get_package to see tags and organizations for any energy dataset to ensure you have the right data.
- Accelerate market research. Use search_datastore to get the exact numbers you need for Brazilian energy reports in seconds.

## How It Works

The bottom line is you get instant access to Brazilian energy records without manually browsing a portal.

1. Subscribe to this Connector in Vinkius.
2. Add your API key if you have specific access requirements.
3. Ask your agent to find or query energy data from the ANEEL portal.

## Frequently Asked Questions

**Can the ANEEL Dados Abertos MCP find specific electricity tariffs?**
Yes, it can search records within specific resources to find exact rates and tariff adjustments for various regions.

**Does the ANEEL Dados Abertos MCP support CSV and PDF files?**
Yes, it can fetch metadata and direct download URLs for various file formats including CSV, PDF, and XLS.

**Can I use the ANEEL Dados Abertos MCP to see all public datasets?**
Yes, it can list all available dataset packages currently hosted on the ANEEL Open Data Portal.

**Is the ANEEL Dados Abertos MCP good for energy market research?**
It is ideal for finding regulatory data, infrastructure information, and distribution metrics for the Brazilian market.

**Can I filter energy data by specific providers?**
Yes, you can query the data store for specific provider names like ENEL to get targeted operational metrics and rates.

**How can I find the specific ID for a dataset like 'Tarifas das Distribuidoras'?**
You can use the `list_packages` tool to see all available names. Once you identify the name, use `get_package` with that ID to see all its internal resources and metadata.

**Can I search for a specific company name inside a CSV resource?**
Yes! If the resource is part of the DataStore, use the `search_datastore` tool. You can provide the `resource_id` and use the `q` parameter for a full-text search or `filters` for specific field matching.

**What information is included in the resource metadata?**
The `get_resource` tool returns the file format (CSV, PDF, etc.), the creation date, the last modification date, and the direct download URL for the data file.