How to Use the ChargeDesk MCP in OpenAI Agents SDK

Q: How do I connect ChargeDesk to OpenAI Agents SDK?

Install the openai-agents package and initialize this MCP server using MCPServerStreamableHttp with your Vinkius URL. Pass this object in the mcpservers array when constructing your agent. Set cacheToolsList=True to speed up initialization.

Build production-ready billing agents with OpenAI Agents SDK that manage refunds and subscriptions safely.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ChargeDesk MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Process Refunds Safely via MCP Server

Execute direct payment reversals using the `refund_chargedesk_payment` tool. OpenAI Agents SDK guardrails validate the refund amount before execution, preventing accidental over-refunds. The agent pulls the transaction ID via this MCP integration and executes the reversal across any connected gateway. Handoffs between specialized agents keep this safe. A tier-one support agent handles the customer conversation and transfers the actual transaction to a restricted billing agent. You get full visibility into the execution path through the OpenAI dashboard tracing.

Audit Connected Payment Gateways

Inspect every active merchant account linked to your system with `list_connected_gateways`. Your Python agent retrieves the current status of Stripe, PayPal, or Braintree connections in one request. This lets your monitoring system detect offline gateways before customers complain. Combine this with `list_chargedesk_webhooks` to verify endpoint configurations. The agent checks if your payment processors are successfully routing event payloads back to your infrastructure. If a webhook drops, the agent flags the failure in your logs automatically.

Retrieve Deep Customer Context

Pull complete billing histories into your agent's context window via the `get_customer_details` tool. The agent passes an email or ID and receives past charges, failed payments, and lifetime value metrics. OpenAI's native tool discovery handles the parameter mapping without manual schema definitions. Managing recurring revenue requires precise data. Agents call `list_chargedesk_subscriptions` to check active, past due, or canceled billing cycles. The AI evaluates the subscription status and decides whether to grant service access or prompt the user for a new credit card.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the `openai-agents` package and initialize this MCP server using `MCPServerStreamableHttp` with your Vinkius URL. Pass this object in the `mcp_servers` array when constructing your agent. Set `cacheToolsList=True` to speed up initialization.

Yes, the SDK handles tool discovery out of the box. Your agent will automatically read the schemas for listing charges and issuing refunds. You do not need to write custom JSON schemas.

Implement guardrails in your agent configuration. You define rules that require human approval for any `refund_chargedesk_payment` call exceeding a specific dollar amount. The agent halts execution until a manager signs off.

Handoffs work natively with these MCP tools. You build one agent strictly for querying data and a separate, restricted agent for executing refunds. The conversational agent routes the user to the billing agent when a transaction is required.

Your subscription histories and payment gateway identifiers never touch our storage. The V8 Isolate Sandbox processes the request in memory and destroys the environment immediately after the response. Your endpoint token is the only authenticated credential required.

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