How to Use the UtilityAPI MCP in Vercel AI SDK

Q: How does UtilityAPI help Vercel AI SDK analyze energy usage?

The getintervals tool provides detailed consumption readings, like hourly or 15-minute kWh values. This granularity lets your agent pinpoint peak usage patterns far better than just looking at a monthly bill.

Q: Does UtilityAPI support tracking multiple customer accounts with Vercel AI SDK?

Yes, you can list all current access permissions using listauthorizations. You'll see which customers have granted access and their unique referral codes. This lets your agent manage many data streams concurrently.

Q: What billing information does UtilityAPI provide to Vercel AI SDK?

The getbills tool returns the necessary financial details, including start/end dates, total cost in dollars, and energy usage (kWh or therms). You can also filter this summary by a specific meter ID.

Q: If I'm building a test environment with Vercel AI SDK, what should I use?

Use testformsubmission. This lets you simulate the full customer authorization process and get a temporary referral code. You can then test data retrieval against that fake setup before going live.

Display real-time utility insights directly in the 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 UtilityAPI MCP to Vercel AI SDK

Create your Vinkius account to connect UtilityAPI 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 UtilityAPI with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Fetch combined billing and interval data for Vercel AI SDK

Need a full picture of customer usage? Use `get_meter_data` to combine bill history with granular, time-series readings in one call. This gives your users both the cost summary and the detailed energy patterns they need. This combined approach works great when you're building user dashboards. The data includes everything from total dollar costs to 15-minute kWh usage.

Manage customer authorization setup for Vercel AI SDK

Before fetching any data, you need consent. Call `create_auth_form` to generate a unique form ID and redirect the customer to share their utility information. This function requires a valid utility code, ensuring your request matches known providers. You can also check available template options using `get_form_templates`. Use these tools to build robust onboarding flows that guide users through data sharing.

Track system status and collection events via the MCP Server

Don't rely on guesswork for data availability. Monitor the workflow using `get_events` to see when authorizations are created or if data collection completes successfully. This is critical for building a reliable client experience. If you suspect usage gaps, run `activate_historical_collection`. You send an array of specific meter IDs and kick off the background process to backfill all available historical records.

Setup guide

Set up UtilityAPI 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 UtilityAPI 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 UtilityAPI 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 UtilityAPI. 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 UtilityAPI 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 UtilityAPI MCP in Vercel AI SDK

The `get_intervals` tool provides detailed consumption readings, like hourly or 15-minute kWh values. This granularity lets your agent pinpoint peak usage patterns far better than just looking at a monthly bill.

Yes, you can list all current access permissions using `list_authorizations`. You'll see which customers have granted access and their unique referral codes. This lets your agent manage many data streams concurrently.

The `get_bills` tool returns the necessary financial details, including start/end dates, total cost in dollars, and energy usage (kWh or therms). You can also filter this summary by a specific meter ID.

Use `test_form_submission`. This lets you simulate the full customer authorization process and get a temporary referral code. You can then test data retrieval against that fake setup before going live.

This server touches sensitive usage data, specifically the meter IDs and associated billing history. Always ensure your client handles these credentials with maximum care.

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