How to Use the UtilityAPI MCP in Cline

Q: How do I get combined billing data using UtilityAPI with Cline?

The best way is to use getmeterdata. This single call pulls both the financial bill history and the granular usage intervals for a specific meter UID. It saves you from having two separate API calls in your code.

Q: What's the best practice for handling multiple utility providers using UtilityAPI with Cline?

Use listutilities first to validate all supported codes (like PG&E or SCE). Then, build a switch statement in your code that uses these validated codes when calling createauthform.

Q: Can I simulate testing the authorization process using UtilityAPI with Cline?

Absolutely. Use testformsubmission. It returns a referral code and allows you to verify your frontend form submissions work correctly before deployment. You can then use this code in other functions.

Q: If I need historical data, what parameters must I provide for UtilityAPI?

For any usage retrieval—whether it's getintervals or getbills—you absolutely must pass the correct meter UID. You get this list using listmeters.

Write production-ready energy analysis components using Cline and UtilityAPI.

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 Cline

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build billing dashboard components with the MCP Server.

Cline lets you write a component that calls `get_billing_summaries`. You pass the API key, specify the meter ID, and it returns cost totals and billing periods. This is perfect for generating reports showing quarterly spending trends without manual data handling.

Code full-cycle usage reporting pipelines.

You can write a script that first uses `list_meters` to get all service points, then iterates through them. For each meter, the component calls `get_intervals` for detailed time-series data. Cline handles the complex loop and structures the output into clean JSON objects.

Set up robust authorization tracking in code.

When a user hits your site, you want to track access. Use `list_authorizations` to pull all granted permissions by referral code. Cline’s strength is letting you immediately write the database schema and API endpoints required to store this metadata.

Setup guide

Set up UtilityAPI MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type utilityapi-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest UtilityAPI refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "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 Cline

The best way is to use `get_meter_data`. This single call pulls both the financial bill history and the granular usage intervals for a specific meter UID. It saves you from having two separate API calls in your code.

Use `list_utilities` first to validate all supported codes (like PG&E or SCE). Then, build a switch statement in your code that uses these validated codes when calling `create_auth_form`.

Absolutely. Use `test_form_submission`. It returns a referral code and allows you to verify your frontend form submissions work correctly before deployment. You can then use this code in other functions.

For any usage retrieval—whether it's `get_intervals` or `get_bills`—you absolutely must pass the correct meter UID. You get this list using `list_meters`.

The server touches billing account summaries and usage interval data (kWh or therms). Always ensure your component is passing authorization IDs, not raw customer names, to maintain compliance.

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