Skip to content
Vinkius

UtilityAPI Connector for AI agents.

12 live capabilities

Pull utility billing and smart meter data from 100+ US providers

Live agent request UtilityAPI / Connector

Waiting for input…

AI Agent

Why people use UtilityAPI

UtilityAPI for Energy Auditing and Solar Sales

With UtilityAPI, your AI agent does the heavy lifting. It pulls granular 15-minute readings and billing history for over 100 providers in seconds. You get a clean dataset for your analysis without ever opening a browser tab.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

What Vinkius changes

You get a single unified gateway to hundreds of different utility providers.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

  1. Real-world use case 01

    Sizing a solar array

    A solar installer asks the agent to pull 12 months of usage for a home to see peak summer AC costs.

  2. Real-world use case 02

    Portfolio auditing

    A property manager asks the agent to find all meters with high gas usage to identify inefficient heating.

  3. Real-world use case 03

    Loan qualification

    A lender asks the agent to check a customer's billing history to see if they pay their utility bills on time.

Complete set · 12capabilities

The complete UtilityAPI capability set.

These are the exact actions your AI can choose when you ask it to work with UtilityAPI.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 12 available through UtilityAPI.

  1. 01 Capability

    Activate historical collection

    Starts a backfill of all available past data for specific meters. This ensures you get a full history instead of just future readings.

  2. 02 Capability

    Create auth form

    Generates a unique form for customers to grant data sharing permissions. You can use this to set up new data sharing agreements securely.

  3. 03 Capability

    Get billing summaries

    Shows costs and meter counts for your specific UtilityAPI account. Use this to track your own API usage and billing periods.

  4. 04 Capability

    Get bills

    Pulls detailed billing history including costs and usage for specific meters. This helps you analyze spending patterns and identify high-cost periods.

Capability set02 / 03

05—08

4 capabilities in this set.

Part of 12 available through UtilityAPI.

  1. 05 Capability

    Get events

    Fetches webhook notifications about authorizations and data collection statuses. Use this to monitor your workflows and debug issues.

  2. 06 Capability

    Get form templates

    Lists the different types of authorization forms available for customers. Use this to see what info you can collect before creating a form.

  3. 07 Capability

    Get intervals

    Retrieves granular 15-minute or hourly smart meter readings for energy analysis. This is ideal for time-series analysis and demand response.

  4. 08 Capability

    Get meter data

    Combines billing history and interval data into a single set of results for one meter. Use this for a complete picture of a customer's energy profile.

Capability set03 / 03

09—12

4 capabilities in this set.

Part of 12 available through UtilityAPI.

  1. 09 Capability

    List utilities

    Shows all 100+ supported utility companies and their unique codes. Use this to find the correct ID for any US provider.

  2. 10 Capability

    Test form submission

    Simulates a customer authorization to test form configurations. Use this during development to ensure your forms work before going live.

  3. 11 Capability

    List authorizations

    Shows all customers who have granted permission to share their utility data. You can filter these by referral codes to track your leads.

  4. 12 Capability

    List meters

    Lists all authorized service points with addresses and fuel types. Use this to see every meter in your portfolio at a glance.

Set up in minutes

One URL. Then ask UtilityAPI to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use UtilityAPI from the conversation.

Choose your client

Live preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_UQcFN9jSbPr5jD0q3QcZWex8kd0ypw9wyAD09b4d/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it UtilityAPI, and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable UtilityAPI for the conversation.

Where the request belongs

Work UtilityAPI can move forward.

Built around the request

Energy consultants and solar installers who are tired of manual data entry and need accurate historical usage to build reliable quotes.

01

Solar Sales Rep

Uses the capability to pull 12 months of usage data to size panels and calculate ROI for customers.

02

Property Manager

Audits utility costs across a large portfolio to spot billing errors or high-usage anomalies.

03

FinTech Analyst

Verifies payment history and energy patterns to qualify customers for green energy loans.

Bring your own AI

Change the model, client or framework. Keep UtilityAPI connected.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • VS Code
  • Windsurf
  • ZCode
  • Cline
  • Zed
  • Continue
  • Kiro
  • Roo Code
  • Zencoder
  • Goose
  • Void
  • Augment Code
  • Amp
  • Qodo
  • Tabnine
  • Pieces
  • Sourcegraph Cody
  • JetBrains
  • Warp
  • Amazon Q
  • Antigravity
  • BoltAI
  • Raycast
  • Jan
  • LM Studio
  • AnythingLLM
  • Open WebUI
  • Msty
  • Cherry Studio
  • LibreChat
  • TypingMind
  • Chorus
  • 5ire
  • n8n
  • LangChain
  • LlamaIndex
  • CrewAI
  • Vercel AI SDK

Before you connect

Questions about UtilityAPI.

The practical details behind the request, access and result.

What utilities does UtilityAPI support?

UtilityAPI connects to over 100 US utility companies, including major providers like PG&E, Con Ed, and National Grid.

Can I get data for both electricity and gas?

Yes, the Connector pulls data for both fuel types, including billing history and granular usage intervals.

How do I get historical data for a new customer?

You can use the backfill capability to trigger a collection of all available past records for a newly authorized meter.

Does this capability let me pay my utility bills?

No, this Connector is for data retrieval and analysis. It does not handle payments or service adjustments.

How do I get permission from a customer to see their data?

You can create an authorization form through the Connector, which the customer then completes to securely share their info.

Can I see 15-minute smart meter readings?

Yes, the capability provides granular interval data, which is much more detailed than standard monthly bills.

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.

Which utility companies are supported?

UtilityAPI supports 100+ US utilities including PG&E (Pacific Gas & Electric), Southern California Edison (SCE), Con Edison, National Grid, SDG&E, LADWP, CenterPoint Energy, and many more. Use the list_utilities capability to see the complete, up-to-date list of supported utilities with their codes. Coverage varies by state and continues to expand.

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.

One connection away

Give your agent a direct line to UtilityAPI.

Connect UtilityAPI once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available