How to Use the Gigs MCP in OpenAI Agents SDK

Q: Can my OpenAI Agents SDK agent handle Gigs billing errors?

Yes, by monitoring usage with getsubscriptionusage and cross-referencing with getaccountdetails. Your agent can flag discrepancies immediately if the reported usage doesn't match your internal logs.

Q: What is the fastest way to list SIMs in OpenAI Agents SDK?

Invoke the listconnectivitysims tool directly within your agent logic. It returns the full SIM inventory, which the agent can then filter or process based on project requirements.

Provision eSIMs and monitor data usage directly within your OpenAI Agents SDK production environment.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gigs MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated eSIM provisioning for OpenAI agents

Your agent handles subscription lifecycle management without manual intervention. By triggering `create_mobile_subscription` and `create_telecom_user`, the system registers new users and activates plans instantly. This setup ensures your production agent remains in control of the telecom stack. It executes logic based on your specific business rules while maintaining clear audit trails.

Real-time usage tracking in OpenAI Agents SDK

Monitor cellular data consumption across your fleet with `get_subscription_usage`. The agent checks specific consumption levels and triggers alerts if thresholds are breached. Stop guessing about billing overruns. The agent queries data metrics directly, allowing for immediate corrective action before costs spiral out of control.

Infrastructure oversight via MCP Server

Connect your agent to the Gigs infrastructure using this MCP Server to list active assets. Use `list_connectivity_sims` and `list_mobile_subscriptions` to maintain an accurate inventory of your deployed devices. This provides a single source of truth for your agent. It identifies active SIMs and project allocations without needing to ping external dashboards.

Setup guide

Set up Gigs 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 Gigs tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Gigs 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="Gigs Agent",
            instructions="You have access to Gigs 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 Gigs. 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 Gigs 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 Gigs MCP in OpenAI Agents SDK

Install the required dependencies and use the MCPServerStreamableHttp class to point your agent at the Gigs endpoint. Pass the server instance into your agent constructor to enable auto-discovery of all tools.

Yes, by monitoring usage with `get_subscription_usage` and cross-referencing with `get_account_details`. Your agent can flag discrepancies immediately if the reported usage doesn't match your internal logs.

The server operates on a zero-trust model where your API token governs all access. Data stays between your agent and the Gigs infrastructure, ensuring no intermediate storage of your telecom records.

Invoke the `list_connectivity_sims` tool directly within your agent logic. It returns the full SIM inventory, which the agent can then filter or process based on project requirements.

It is built for production, providing direct access to the Gigs API. You can implement custom guardrails around tool calls to ensure your agent only executes authorized telecom operations.

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