How to Use the UtilityAPI MCP in LlamaIndex

Q: How can LlamaIndex use UtilityAPI to analyze customer spending?

You call getbills with a specific meter UID. The resulting bill history (costs and usage) is then indexed by the MCP Server, allowing your LlamaIndex application to answer complex questions about historical spending.

Q: How do I monitor data collection with UtilityAPI in LlamaIndex?

Use getevents to get status updates—like when a new authorization is created or when collection completes. Indexing these events helps your LlamaIndex application track the entire lifecycle of customer data sharing.

Q: If I need to test form setup with UtilityAPI in LlamaIndex?

Use createauthform first. Then, run testformsubmission. This generates a temporary referral code you can use to confirm the workflow is correct before linking it permanently.

Build knowledge-augmented RAG applications with LlamaIndex 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 LlamaIndex

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Querying Billing Data using the MCP Server

Need to answer a question like, 'What was the cost spike last quarter?' Use `get_bills` to get comprehensive billing records. LlamaIndex takes this structured data and indexes it into your vector store. Now you can query past sessions or documents and get answers grounded in actual utility spending. The output of `get_bills`, including dates, costs, and energy usage, becomes a searchable knowledge base for your RAG application.

Tracking Meter Status with LlamaIndex

When you run `list_meters`, you get a list of all service points. You can index this metadata into LlamaIndex. This allows users to query the status and fuel type (gas/electric) of meters without needing to write complex filters. The resulting data is searchable alongside other corporate documents. This makes your entire knowledge base richer, linking technical assets (the meter list) with operational policies.

Getting Detailed Usage Data for LlamaIndex

Detailed usage patterns are critical. Use `get_intervals` to fetch granular data—think 15-minute readings of kWh or therms. Passing this output to LlamaIndex means your users can search not just *what* the bill said, but *when* the peak usage occurred. It’s a massive upgrade over simple lookups because you index the time-series data itself.

Setup guide

Set up UtilityAPI MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all UtilityAPI MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to UtilityAPI tools.",
)
response = await agent.run("List recent UtilityAPI data")

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 LlamaIndex

You call `get_bills` with a specific meter UID. The resulting bill history (costs and usage) is then indexed by the MCP Server, allowing your LlamaIndex application to answer complex questions about historical spending.

The server handles utility billing, interval consumption readings (kWh or therms), and authorization records. All this sensitive data is indexed into your knowledge base via the MCP Server's output.

Use `get_events` to get status updates—like when a new authorization is created or when collection completes. Indexing these events helps your LlamaIndex application track the entire lifecycle of customer data sharing.

Absolutely. Since it provides structured, real-world API outputs, the MCP Server makes this data easily digestible and searchable within your unified index, preventing hallucinations.

Use `create_auth_form` first. Then, run `test_form_submission`. This generates a temporary referral code you can use to confirm the workflow is correct before linking it permanently.

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