Which utility companies are supported?

The MCP supports over 100 US utility companies, including major providers like PG&E, SCE, Con Edison, and National Grid.

How do I get data from a new customer?

You use the create_auth_form capability to generate a link. Once the customer completes the form, you can list their meters and pull their data.

Can I get data more granular than a monthly bill?

Yes, you can use the get_intervals capability to access 15-minute or hourly smart meter readings.

What is the difference between get_bills and get_meter_data?

get_bills only returns the monthly billing history and costs. get_meter_data returns both the billing history and the granular usage intervals in one call.

How do I get historical data for a newly authorized meter?

You must call the activate_historical_collection capability after the meter is authorized to trigger the backfilling process.

How do I get access to a customer's utility billing and usage data?

First, create an authorization form using create_auth_form with the customer's utility code. Share the form URL with the customer to complete authorization. Once authorized, use list_meters to find their service points, then get_bills and get_intervals with the meter UID to retrieve their data. You can also activate historical collection with activate_historical_collection to backfill past data.

What's the difference between bills and intervals data?

Bills provide monthly (or billing cycle) summaries: total cost, total usage (kWh/therms), and billing period dates. Intervals provide granular time-series data from smart meters. typically 15-minute or hourly readings showing exact consumption patterns throughout the day. Use bills for cost analysis and trend overview; use intervals for detailed energy modeling, peak demand identification, and time-of-use analysis.

Can I test the authorization flow before going to production?

Yes! Use create_auth_form to create a form, then test_form_submission with utility='DEMO' and scenario='residential' (or 'commercial'). This simulates a customer authorizing their data and returns a referral_code. Use this code with list_authorizations?referrals=YOUR_CODE&include=meters to retrieve test authorization and meter data without needing a real customer.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect UtilityAPI to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Get granular billing and smart meter data from 100+ providers.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 12 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 12 available through UtilityAPI.

01
Activate historical collection
Triggers the backfilling of historical data for specific meters. Use this after a customer authorizes access to ensure you get their full usage history rather than just new data.
02
Create auth form
Generates a unique authorization form URL for customers. This allows users to securely grant you access to their utility accounts through a standard flow.
03
Get billing summaries
Retrieves your UtilityAPI account billing details. You can check your own subscription costs and usage periods here.
04
Get form templates
Provides the available templates for customer authorization. Use these IDs when you need to create a specific type of data-sharing form.

Capability set02 / 03

05-08

4 capabilities in this set.

Part of 12 available through UtilityAPI.

05
Get intervals
Fetches granular time-series data from smart meters. This provides 15-minute or hourly readings for deep energy analysis.
06
Get meter data
Combines billing history and interval data into one response. It's the fastest way to get a full picture of both costs and usage patterns for a meter.
07
List authorizations
Lists all customers who have granted data access. You can filter these by referral codes to track specific signups.
08
List utilities
Shows every supported utility company and their specific codes. You'll need these codes to create authorization forms.

Capability set03 / 03

09-12

4 capabilities in this set.

Part of 12 available through UtilityAPI.

09
Test form submission
Simulates a customer authorization for testing purposes. It returns a referral code so you can verify your workflow works before going live.
10
Get bills
Retrieves historical utility bills including costs and energy amounts. This is the primary capability for analyzing monthly spending and usage totals.
11
Get events
Provides a feed of webhook events. Use this to monitor when new authorizations are created or when data collection is finished.
12
List meters
Returns a list of all authorized service points. Each meter entry includes the address, fuel type, and unique ID needed for data queries.

Real work

What teams actually run

Solar System Sizing

An installer uses the agent to pull 12 months of electricity usage to accurately predict solar production needs.

Energy Audit Automation

A consultant uses interval data to identify exactly when a building's peak energy demand occurs.

Loan Verification

A lender uses the agent to check a customer's utility payment history to approve an energy upgrade loan.

Portfolio Monitoring

A property manager uses the agent to track utility costs across multiple addresses to find spikes in consumption.

Automate a task

Put UtilityAPI to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

UtilityAPI works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put UtilityAPI to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

865ms average. Fast in production.

UtilityAPI is checked daily against the live service.

Daily averagePeak 1192ms

Oct 11Today

Fastest day: 686ms
Slowest day: 1192ms
14-day trend: Slowing+74%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 12 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of UtilityAPI, so you can see the experience inside your AI.

It does not authenticate your account with UtilityAPI. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

UtilityAPI Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_UQcFN9jSbPr5jD0q3QcZWex8kd0ypw9wyAD09b4d/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — UtilityAPI capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "utilityapi-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_UQcFN9jSbPr5jD0q3QcZWex8kd0ypw9wyAD09b4d/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up UtilityAPI in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work UtilityAPI owners hand off.

This MCP is built for professionals in the energy and finance sectors who need to automate utility data collection.

01
Solar Installers
They use the agent to pull historical usage to size solar arrays and build ROI models.
02
Energy Consultants
They hand off bill analysis to the agent to find efficiency improvements for clients.
03
FinTech Analysts
They use the agent to verify utility payment history for energy efficiency loan approvals.
04
Property Managers
They use the agent to monitor consumption across entire portfolios to spot billing anomalies.

FAQ

Questions UtilityAPI owners ask.

01
Which utility companies are supported?
The MCP supports over 100 US utility companies, including major providers like PG&E, SCE, Con Edison, and National Grid.
02
How do I get data from a new customer?
You use the create_auth_form capability to generate a link. Once the customer completes the form, you can list their meters and pull their data.
03
Can I get data more granular than a monthly bill?
Yes, you can use the get_intervals capability to access 15-minute or hourly smart meter readings.
04
What is the difference between get_bills and get_meter_data?
get_bills only returns the monthly billing history and costs. get_meter_data returns both the billing history and the granular usage intervals in one call.
05
How do I get historical data for a newly authorized meter?
You must call the activate_historical_collection capability after the meter is authorized to trigger the backfilling process.
06
How do I get access to a customer's utility billing and usage data?
First, create an authorization form using create_auth_form with the customer's utility code. Share the form URL with the customer to complete authorization. Once authorized, use list_meters to find their service points, then get_bills and get_intervals with the meter UID to retrieve their data. You can also activate historical collection with activate_historical_collection to backfill past data.
07
What's the difference between bills and intervals data?
Bills provide monthly (or billing cycle) summaries: total cost, total usage (kWh/therms), and billing period dates. Intervals provide granular time-series data from smart meters. typically 15-minute or hourly readings showing exact consumption patterns throughout the day. Use bills for cost analysis and trend overview; use intervals for detailed energy modeling, peak demand identification, and time-of-use analysis.
08
Can I test the authorization flow before going to production?
Yes! Use create_auth_form to create a form, then test_form_submission with utility='DEMO' and scenario='residential' (or 'commercial'). This simulates a customer authorizing their data and returns a referral_code. Use this code with list_authorizations?referrals=YOUR_CODE&include=meters to retrieve test authorization and meter data without needing a real customer.

Explore

More in Data Management

Connect UtilityAPI to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Activate historical collection

Create auth form

Get billing summaries

Get form templates

05-08

Get intervals

Get meter data

List authorizations

List utilities

09-12

Test form submission

Get bills

Get events

List meters

What teams actually run

Solar System Sizing

Energy Audit Automation

Loan Verification

Portfolio Monitoring

Building your own app? The connector is yours to use.

UtilityAPI Connector

Claude Desktop

Solar Installers

Energy Consultants

FinTech Analysts

Property Managers

Which utility companies are supported?

How do I get data from a new customer?

Can I get data more granular than a monthly bill?

What is the difference between get_bills and get_meter_data?

How do I get historical data for a newly authorized meter?

How do I get access to a customer's utility billing and usage data?

What's the difference between bills and intervals data?

Can I test the authorization flow before going to production?

Arcadia Plug AI Connector

EIA State Energy — U.S. Regional Energy Data AI Connector

Eurostat Environment — EU Green Data AI Connector

DataFrame Aggregator Engine AI Connector

Suggestions

OpenMeter (Usage Metering for AI/Cloud Billing) AI Connector

Data Pipeline Prover AI Connector

Hevo Data (ETL & Data Pipeline) AI Connector

PG&E Public Datasets AI Connector