How to Use the Arcadia Utility Cloud MCP in OpenAI Agents SDK

Build production utility tracking agents with OpenAI Agents SDK. Auto-discover accounts and validate meter reads with built-in guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Arcadia Utility Cloud MCP to OpenAI Agents SDK

Create your Vinkius account to connect Arcadia Utility Cloud to OpenAI Agents SDK 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 Arcadia Utility Cloud with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Discover Utility Accounts via MCP Server

The `list_accounts` tool feeds available Arcadia Utility Cloud endpoints directly into your OpenAI agent context. Running this function lets your system map out active utility connections before attempting any data extraction. You get an array of active account IDs that subsequent agent handoffs can process in parallel. Tracing these MCP discovery calls happens automatically in your OpenAI dashboard. Passing the Vinkius endpoint to `MCPServerStreamableHttp` ensures your agent knows exactly which accounts exist without hardcoding configurations. Your deployed product handles dynamic account additions without requiring code deploys.

Extract Meter Data with Guardrails

Calling `get_meter_data` through the MCP server pulls raw consumption metrics for specific utility hardware. Your specialized analytics agent requests this data, and the framework validates the request parameters before execution. Getting historical usage numbers allows your system to detect anomalies or calculate carbon footprints. Caching tool lists improves performance when querying hundreds of meters. Setting `cacheToolsList=True` in the Agent constructor prevents redundant discovery calls during heavy data extraction. The system pulls the metrics efficiently while maintaining strict safety constraints on how often the API gets hit.

Audit Statements in Production

Extracting billing metadata requires the `list_statements` and `get_statement` functions. These tools give your financial agents the ability to pull invoice dates, amounts, and periods across all tracked utilities. Fetching this data through the SDK means you can route high-value bills to human reviewers while auto-approving standard charges. Production environments demand reliability when handling financial records. The Vinkius ephemeral sandbox ensures that your statement queries run in an isolated V8 environment. Your agent retrieves the billing details, processes the ledger entry, and the sandbox vanishes immediately.

Setup guide

Set up Arcadia Utility Cloud MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Arcadia Utility Cloud tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Arcadia Utility Cloud tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Arcadia Utility Cloud tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Arcadia Utility Cloud Agent",
            instructions="You have access to Arcadia Utility Cloud tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 Arcadia. 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 Arcadia Utility Cloud 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 Arcadia Utility Cloud MCP in OpenAI Agents SDK

Install the openai-agents package via pip. Initialize MCPServerStreamableHttp with your Vinkius endpoint URL and pass it to the mcp_servers array in your Agent constructor.

Yes, you can divide utility tasks across multiple specialized agents. A discovery agent can run list_meters, then pass those IDs to an analytics agent that executes get_meter_data.

Your Vinkius token might be expired or missing from the request headers. Verify the token in your environment variables and ensure the async context manager is active when the agent attempts to run get_account_check.

The SDK logs every tool execution automatically. You'll see exactly when the agent decided to call get_statement and the raw JSON response it received.

The server processes raw billing amounts, meter numbers, and usage history. Every request runs inside a zero-trust V8 isolate sandbox on Vinkius, meaning your financial metadata passes through an ephemeral environment that destroys itself the moment the connection closes.

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