How to Use the ANEEL Dados Abertos MCP in Windsurf

Q: How does Windsurf use ANEEL Dados Abertos to map Brazilian utility rates?

Cascade calls listpackages to locate tariff datasets and then queries the datastore to extract specific rates. The agent processes these rows locally to build your analytical scripts.

Q: Can Windsurf chain multiple ANEEL Dados Abertos tools to build a local dataset?

Yes, Windsurf uses this MCP connection to run getpackage to find resources and then uses searchdatastore to pull the exact rows. It writes the results directly to your workspace files in one go.

Q: Where do I configure the ANEEL Dados Abertos MCP Server in Windsurf?

Add the server configuration to your /.codeium/windsurf/mcpconfig.json file under the mcpServers block. Cascade will instantly discover the four ANEEL tools upon reload.

Q: What happens if an ANEEL resource is too large for the Windsurf context window?

Use searchdatastore with specific filters to limit the records returned. This keeps the data payload small enough for Cascade to analyze without hitting token limits.

Let Cascade pull live Brazilian electricity datasets directly into your Windsurf workspace to map energy grids without manual API calls.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ANEEL Dados Abertos MCP to Windsurf

Create your Vinkius account to connect ANEEL Dados Abertos to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ANEEL Dados Abertos with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map Brazilian energy grids with Windsurf and MCP

The ANEEL Dados Abertos MCP Server lets Cascade handle the tedious exploration of Brazilian power grid data by chaining queries. When you ask to analyze regional tariffs, Cascade triggers `list_packages` to find the relevant datasets and immediately follows up with `get_package` to inspect their structures. You do not need to copy-paste URLs or write custom scraper scripts in your Windsurf workspace. The agent reads the ANEEL package metadata, selects the correct electrical utility files, and loads them into Cascade autonomously.

Run complex datastore searches inside Cascade

By using the `search_datastore` tool, Cascade drills down into huge ANEEL tables to extract specific utility metrics. If you need historical generation data for a specific wind farm, Cascade writes the search parameters and executes the query without asking for your intervention at each step. The tool feeds raw Brazilian utility data rows directly to Cascade's context window. This lets the Windsurf model run immediate calculations or generate visualizations of Brazilian energy trends right inside your active editor.

Pull raw ANEEL CSV and PDF links instantly

The `get_resource` tool pinpoints the exact URL and file format of the ANEEL records Cascade needs, bypassing the clunky web portal entirely. Once Cascade gets the resource link, it can pull the energy data into your Windsurf workspace, parse the contents, and immediately start refactoring your analytical models.

Setup guide

Set up ANEEL Dados Abertos MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the ANEEL Dados Abertos MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my ANEEL Dados Abertos payment history." If connected, Cascade will call the ANEEL Dados Abertos tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "aneel-dados-abertos-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ANEEL Dados Abertos. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ANEEL Dados Abertos now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ANEEL Dados Abertos MCP in Windsurf

Cascade calls `list_packages` to locate tariff datasets and then queries the datastore to extract specific rates. The agent processes these rows locally to build your analytical scripts.

Yes, Windsurf uses this MCP connection to run `get_package` to find resources and then uses `search_datastore` to pull the exact rows. It writes the results directly to your workspace files in one go.

Add the server configuration to your `~/.codeium/windsurf/mcp_config.json` file under the `mcpServers` block. Cascade will instantly discover the four ANEEL tools upon reload.

Use `search_datastore` with specific filters to limit the records returned. This keeps the data payload small enough for Cascade to analyze without hitting token limits.

Yes, because the server only reads public Brazilian electricity sector records and ANEEL dataset metadata. Vinkius runs this in a zero-trust sandbox, meaning no local files or private environment variables are exposed to the external API.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript