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

Q: How can I get time-series data with U.S. EIA Energy Data using Vercel AI SDK?

Use the getenergyseriesdata tool. It accepts specific metrics and time ranges, fetching structured time-series data for you. You'll stream this dataset directly into your application UI via the Vercel AI SDK.

Q: Does U.S. EIA Energy Data support listing coal production with Vercel AI SDK?

Yep. Call listcoalproduction to get current U.S. coal production and distribution data. The results stream into your frontend, letting you display the numbers as they are retrieved.

Q: Which tools can I use with U.S. EIA Energy Data in Vercel AI SDK?

You have access to about ten tools, including listelectricitygeneration, listnaturalgasproduction, and quickusenergyaudit. These all expose real-time data that you can stream into your user interface.

Q: What is the best way to handle U.S. EIA Energy Data queries with Vercel AI SDK?

Start by calling geteiaapimetadata to check the connection status and available endpoints. This ensures your agent knows exactly what's available before you stream out any major datasets.

Stream real-time U.S. EIA Energy Data results directly into your UI using Vercel AI SDK.

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 Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Monitor fuel prices in real time.

The `list_petroleum_prices` tool fetches current U.S. petroleum and gasoline price data. You can stream these results directly into your React component, letting the user see price changes appear live without any loading spinner. This is perfect for building dashboard widgets that need immediate feedback. The streaming nature of the Vercel AI SDK means you're not waiting on a single API call; you’re showing the data as it arrives.

Get an energy health snapshot.

Use `quick_us_energy_audit` to get a high-level summary of current U.S. energy production across all sources. The results stream instantly into your frontend, allowing you to build dynamic status indicators that update in real time. Because the Vercel AI SDK supports streaming text, you can present this audit data in digestible chunks as it's generated by your agent, making the whole experience feel incredibly fast and responsive.

Access all energy metrics via MCP Server

The `list_energy_categories` tool lists every U.S. EIA energy data category available. This lets you build a robust selection menu for your users, showing them exactly what kinds of data they can query. You'll call this through the Vercel AI SDK and stream the resulting list into your UI. It’s ideal groundwork for any complex application because it surfaces all possible data dimensions upfront.

Setup guide

Set up U.S. EIA Energy Data MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all U.S. EIA Energy Data tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent U.S. EIA Energy Data transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Use the `get_energy_series_data` tool. It accepts specific metrics and time ranges, fetching structured time-series data for you. You'll stream this dataset directly into your application UI via the Vercel AI SDK.

Yep. Call `list_coal_production` to get current U.S. coal production and distribution data. The results stream into your frontend, letting you display the numbers as they are retrieved.

You have access to about ten tools, including `list_electricity_generation`, `list_natural_gas_production`, and `quick_us_energy_audit`. These all expose real-time data that you can stream into your user interface.

Start by calling `get_eia_api_metadata` to check the connection status and available endpoints. This ensures your agent knows exactly what's available before you stream out any major datasets.

This server touches structured energy statistics, including electricity generation metrics and fuel price points. Since the data is read-only via API calls, you're only dealing with aggregated public reports.

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