How to Use the Clip API MCP in OpenAI Agents SDK

Give your OpenAI Agents SDK direct control over Clip payments. Generate links, issue refunds, and track settlements automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Clip API MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Clip Payments via OpenAI Agents SDK

You want your production agent handling money without needing constant human supervision. Hooking this MCP Server up to OpenAI Agents SDK lets your system generate a `create_payment_link` on the fly when a customer is ready to buy. It fires off the link, waits for the charge to clear, and keeps the conversation moving. Mistakes happen in e-commerce, so you need a way to walk back charges safely. Passing `refund_transaction` to your agent means it can handle customer complaints by issuing partial or full returns instantly. OpenAI's built-in guardrails ensure the agent checks transaction states before sending any money back.

Track Settlements and Cash Balances

Waiting on cash to hit your bank account is the hardest part of retail. Your agent can call `get_balance_summary` to see exactly what funds are pending settlement from yesterday's sales. It pulls the raw numbers straight from Clip. Auditing past payouts usually requires downloading CSVs and matching rows manually. Instead, you just have your system run `get_settlement_reports` to grab historical payout data. The agent hands that data off to a specialized reporting agent to build your daily financial summary.

Manage Subscriptions and Inventory

Charging clients on a recurring basis keeps revenue predictable. By exposing `create_subscription_plan`, your AI builds custom billing cycles for VIP customers during a chat session. The setup happens entirely in the background. Keeping your POS system updated shouldn't require logging into a dashboard. Your agent uses `add_product_to_catalog` to push new items directly to your physical Clip terminals. It pairs perfectly with `list_products_catalog` to check existing stock before creating duplicates.

Setup guide

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

Create your Agent

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

Run the agent

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

You install the openai-agents package first. Then create an MCPServerStreamableHttp instance with your Vinkius endpoint. Pass that into your Agent constructor's mcp_servers list, and tools auto-discover immediately.

Yes, it generates them instantly. The agent calls the creation tool and returns a URL you can text or email to a buyer.

Your agent triggers the refund tool with a transaction ID. You can specify an exact amount for a partial return or leave it blank to void the whole charge.

Set cacheToolsList to true in your configuration. This stops the agent from refetching the tool definitions on every single request. Performance improves significantly when dealing with multiple payment operations.

Your settlement numbers and product catalogs stay completely isolated. Vinkius spins up a temporary V8 sandbox for every single request. Once the balance check or refund completes, the environment dies instantly.

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