How to Use the U.S. EIA Energy Data MCP in Mastra AI

Q: How do I get time-series data with U.S. EIA Energy Data using Mastra AI?

Use the getenergyseriesdata tool within a workflow. You define the input parameters (like metric and date range), and the agent handles calling it, managing retries if the initial connection fails.

Q: Can Mastra AI list electricity generation data?

Yes, use listelectricitygeneration to get U.S. electricity generation and retail sales data. You can wrap this call in a workflow that ensures the data is processed even if downstream analysis tools have temporary issues.

Q: What happens if I need to list petroleum prices with U.S. EIA Energy Data using Mastra AI?

The listpetroleumprices tool fetches gasoline and petroleum price data. You can set up a workflow where the agent calls this, waits for success, and then proceeds to other dependent tasks without human intervention.

Build complex, failure-tolerant workflows using U.S. EIA Energy Data with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect U.S. EIA Energy Data MCP to Mastra AI

Create your Vinkius account to connect U.S. EIA Energy Data to Mastra AI 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 U.S. EIA Energy Data with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Execute multi-step energy audits.

The `quick_us_energy_audit` tool provides a high-level summary of current U.S. energy production across all sources. You can build an automated workflow that runs this audit, and if the data is incomplete, it automatically retries by calling `get_eia_api_metadata` first. This ability to handle failures gracefully means your agent doesn't just fail out; it follows a structured process—like checking connection status before reporting energy health.

Track regional fuel price variations.

Use `list_regional_fuel_prices` to identify how fuel prices vary across different U.S. regions. Your Mastra AI workflow can process this list, and if the first region fails to report, it automatically backs off and tries the next defined region. This built-in resilience is huge for finance apps that depend on consistent external data feeds like regional pricing.

Compare gas production vs. coal.

You can chain together calls to `list_natural_gas_production` and `list_coal_production`. The workflow engine first gathers the supply data, then sends it to a second step that compares it against historical trends. It handles this sequence even if one source temporarily goes down. This level of control over execution flow makes your agent reliable for critical business logic involving energy resource comparison.

Setup guide

Set up U.S. EIA Energy Data MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All U.S. EIA Energy Data tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "us-eia-energy-data-mcp-client",
  servers: {
    "us-eia-energy-data-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "U.S. EIA Energy Data Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to U.S. EIA Energy Data tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent U.S. EIA Energy Data transactions"
);
console.log(result.text);

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 U.S. EIA Energy Data. 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 U.S. EIA Energy Data 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 U.S. EIA Energy Data MCP in Mastra AI

Use the `get_energy_series_data` tool within a workflow. You define the input parameters (like metric and date range), and the agent handles calling it, managing retries if the initial connection fails.

Yes, use `list_electricity_generation` to get U.S. electricity generation and retail sales data. You can wrap this call in a workflow that ensures the data is processed even if downstream analysis tools have temporary issues.

The `list_petroleum_prices` tool fetches gasoline and petroleum price data. You can set up a workflow where the agent calls this, waits for success, and then proceeds to other dependent tasks without human intervention.

It handles them by allowing you to define complex conditional logic. For instance, if the `quick_us_energy_audit` fails, your workflow can branch out to check regional prices instead.

This server touches energy statistics and price lists. You're dealing with aggregated metrics like natural gas production rates and electricity generation counts, which are read-only public data.

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