UtilityAPI Connector for AI agents.
12 live capabilities
Pull utility billing and smart meter data from 100+ US providers
Waiting for input…
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.
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
- 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.
- 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.
- 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.
01—04
4 capabilities in this set.
Part of 12 available through UtilityAPI.
- 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.
- 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.
- 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.
- 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.
05—08
4 capabilities in this set.
Part of 12 available through UtilityAPI.
- 05 Capability
Get events
Fetches webhook notifications about authorizations and data collection statuses. Use this to monitor your workflows and debug issues.
- 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.
- 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.
- 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.
09—12
4 capabilities in this set.
Part of 12 available through UtilityAPI.
- 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.
- 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.
- 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.
- 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 previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_UQcFN9jSbPr5jD0q3QcZWex8kd0ypw9wyAD09b4d/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it UtilityAPI, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable UtilityAPI for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_UQcFN9jSbPr5jD0q3QcZWex8kd0ypw9wyAD09b4d/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the UtilityAPI URL.
- Step 03
Save and start
Save the connection and enable UtilityAPI in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"utilityapi": {
"url": "https://edge.vinkius.com/vk_preview_UQcFN9jSbPr5jD0q3QcZWex8kd0ypw9wyAD09b4d/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using UtilityAPI
Open Agent mode in chat and ask: "Using UtilityAPI, help me...". 12 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"utilityapi": {
"url": "https://edge.vinkius.com/vk_preview_UQcFN9jSbPr5jD0q3QcZWex8kd0ypw9wyAD09b4d/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using UtilityAPI
Ask Copilot: "Using UtilityAPI, help me...". 12 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"utilityapi": {
"url": "https://edge.vinkius.com/vk_preview_UQcFN9jSbPr5jD0q3QcZWex8kd0ypw9wyAD09b4d/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using UtilityAPI
Open Cascade and ask: "Using UtilityAPI, help me...". 12 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"utilityapi": {
"url": "https://edge.vinkius.com/vk_preview_UQcFN9jSbPr5jD0q3QcZWex8kd0ypw9wyAD09b4d/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using UtilityAPI
Ask Cline: "Using UtilityAPI, help me...". 12 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add utilityapi --transport http "https://edge.vinkius.com/vk_preview_UQcFN9jSbPr5jD0q3QcZWex8kd0ypw9wyAD09b4d/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using UtilityAPI
Ask Claude: "Using UtilityAPI, show me...". 12 tools are ready
Where the request belongs
Work UtilityAPI can move forward.
Energy consultants and solar installers who are tired of manual data entry and need accurate historical usage to build reliable quotes.
Solar Sales Rep
Uses the capability to pull 12 months of usage data to size panels and calculate ROI for customers.
Property Manager
Audits utility costs across a large portfolio to spot billing errors or high-usage anomalies.
FinTech Analyst
Verifies payment history and energy patterns to qualify customers for green energy loans.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsPG&E Public Datasets
Access PG&E public energy data: monthly usage, billing, savings, and regional comparisons.
Arcadia Plug
Access and manage utility data with Arcadia Plug. track accounts, statements, and meters via AI.
PG&E Data Portals
Search and query PG&E energy datasets: usage, EV adoption, solar, grid data.
Arcadia Utility Cloud
Automate utility data collection with Arcadia Utility Cloud. track accounts, bills, and usage via AI.
OpenEI
US electricity rate intelligence. query utility rates by location, sector, and tariff via AI for solar and energy analysis.
NREL Energy Data
Access renewable energy and fuel data via NREL. track fuel stations, solar resources, and utility rates directly from your AI agent.
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