How to Use the UtilityAPI MCP in Cursor

Q: How do I query billing summaries using UtilityAPI in Cursor?

Use the getbillingsummaries tool. This provides your API usage costs and helps you track general billing periods for your account without needing to specify a meter ID. It’s useful for monitoring operational expenditure.

Q: What is the best way to check if historical data collection worked with UtilityAPI in Cursor?

You should use getevents. This tool monitors your workflow, telling you when 'collection completed' or logging any errors. You can write code that checks this event log before proceeding with data analysis.

Q: If I need a list of all available utilities to query with UtilityAPI in Cursor, what do I call?

Run listutilities. This function returns the name and required utility code for every supported company. You'll need these codes when calling createauthform.

Q: I need to pull historical bill details for a list of meters using UtilityAPI with Cursor. Which tool is best?

You should use getbills. It requires the meter UIDs and returns structured data including start/end dates, total cost, energy usage (kWh or therms), and the associated utility name.

Inject live utility data into your code with Cursor.

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 Cursor

Create your Vinkius account to connect UtilityAPI to Cursor 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get Full Billing and Usage Data

When you need a complete view of customer consumption, use the `get_meter_data` tool. It combines the entire bill history—dates, costs, usage—with granular time-series readings in one call. This means less code and more actionable data injected right into your script. This method is perfect for writing scripts that calculate total lifetime cost or model energy patterns over years of historical data.

Build Authorization Logic

Start by calling `list_utilities` to pull every valid utility code. Then, use `create_auth_form` with the correct code and desired scenario (residential/commercial). This function returns a form UID that your code must handle when setting up data access. You can then test this entire setup using `test_form_submission`, which gives you a referral code to validate against `list_authorizations` before committing the logic.

Analyze Energy Patterns

To analyze usage patterns, call `get_intervals`. You must pass the meter UIDs here. The response provides detailed time-series readings (15-min or hourly) for usage and cost. This is ideal for your code when you're building demand response simulations. Alternatively, if you only care about financial totals, `get_bills` works great, giving you the summarized period costs without needing minute-by-minute data.

Setup guide

Set up UtilityAPI MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the UtilityAPI MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent UtilityAPI transactions." If the MCP tools are loaded correctly, Cursor will call the UtilityAPI tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "utilityapi-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Cursor

Use the `get_billing_summaries` tool. This provides your API usage costs and helps you track general billing periods for your account without needing to specify a meter ID. It’s useful for monitoring operational expenditure.

You should use `get_events`. This tool monitors your workflow, telling you when 'collection completed' or logging any errors. You can write code that checks this event log before proceeding with data analysis.

Run `list_utilities`. This function returns the name and required utility code for every supported company. You'll need these codes when calling `create_auth_form`.

This UtilityAPI server touches usage data, billing records, and meter UIDs. The specific types are energy consumption metrics like kWh or therms, and financial cost figures in dollars.

You should use `get_bills`. It requires the meter UIDs and returns structured data including start/end dates, total cost, energy usage (kWh or therms), and the associated utility name.

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