How to Use the Electricity Maps Carbon Intelligence MCP in Vercel AI SDK

Q: How do I stream Electricity Maps Carbon Intelligence data with Vercel AI SDK?

Install the @ai-sdk/mcp package and initialize the client using createMCPClient. You then pass the tools directly into streamText to let your agent query real-time carbon data.

Stream real-time grid carbon data directly into your Next.js frontend with 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 Electricity Maps Carbon Intelligence MCP to Vercel AI SDK

Create your Vinkius account to connect Electricity Maps Carbon Intelligence 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 Electricity Maps Carbon Intelligence with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream real-time emissions data using Vercel AI SDK

The `get_carbon_intensity` tool fetches current carbon emissions data for any global grid zone like US-CA or DE. Your frontend streaming component calls this tool through the MCP Server to render live carbon metrics directly to the user. Your users see the actual carbon numbers update in real-time as the data streams in. No loading spinners or stale page refreshes, just raw grid intensity data rendered instantly on the edge.

Map global clean energy zones instantly

The `list_energy_zones` tool retrieves the complete catalog of supported grid regions across the globe. Your AI client reads this list to map out coordinates and zone IDs for any query. Using this tool inside your edge functions lets you build interactive maps. Users get instant feedback on which energy zones are currently supported without waiting on slow database lookups.

Analyze live fuel mix breakdown

The `get_power_production_breakdown` tool pulls the exact fuel mix powering a specific grid right now. It shows the percentages of wind, solar, coal, and gas currently active in the zone. Your UI components render this breakdown immediately as the AI client streams the response. Exactly. You get the exact percentage of low-carbon power without writing custom parsers.

Setup guide

Set up Electricity Maps Carbon Intelligence 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 Electricity Maps Carbon Intelligence 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 Electricity Maps Carbon Intelligence 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 Electricity Maps. 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 Electricity Maps Carbon Intelligence 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 Electricity Maps Carbon Intelligence MCP in Vercel AI SDK

Install the `@ai-sdk/mcp` package and initialize the client using `createMCPClient`. You then pass the tools directly into `streamText` to let your agent query real-time carbon data.

Yes, the server runs in a secure V8 sandbox. Since the Vercel AI SDK works on the edge, you can query carbon metrics with minimal latency.

The server passes API responses directly to your client. If you hit rate limits, write standard TypeScript retry logic around the tool calls in your edge route.

Yes, Vinkius handles the authentication behind a single secure endpoint token. Your Vercel AI SDK configuration only needs to point to this unified endpoint for this MCP setup.

This MCP Server only processes the energy zone IDs and coordinates you query. Your location data and query parameters are processed in an ephemeral sandbox and never stored.

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