How to Use the PayPal MCP in OpenAI Agents SDK

Q: How does OpenAI Agents SDK handle PayPal subscription suspension?

Your agent calls suspendsubscription automatically when it detects delinquent customer accounts. The SDK traces this action in your dashboard, showing the exact tool parameters and the response from the payment gateway.

Q: What is the best way to handle high-value payments with this toolset?

Run authorizeorder to reserve the buyer's funds immediately. Once your inventory agent confirms stock is ready, a separate agent can execute captureorder to finalize the transaction.

Run safe, multi-agent financial operations with OpenAI Agents SDK using this PayPal MCP Server to process payments and manage subscriptions.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect PayPal MCP to OpenAI Agents SDK

Create your Vinkius account to connect PayPal to OpenAI Agents SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup PayPal with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-Agent Order Routing with OpenAI Agents SDK

`create_order` initializes the payment flow directly within your multi-agent architecture. Your agent routes checkout details to a specialized verification agent, confirming purchase parameters are correct before executing the transaction. This setup uses OpenAI's built-in guardrails to check payloads before calling `authorize_order`. The agent handles high-value transactions by holding authorizations, letting a supervisor agent trigger `capture_order` only after verifying physical stock.

Secure Subscription Management and Safety Guardrails

`get_subscription` retrieves the current billing status of recurring customers directly into the OpenAI dashboard trace. Your agent monitors active memberships, automatically running `suspend_subscription` when payment failures occur. OpenAI's tracing system records every execution of `cancel_subscription`. If an agent attempts to terminate a plan, the SDK evaluates custom safety rules to confirm the user actually requested the cancellation.

Automated Refunds and Voiding via MCP Server

`refund_capture` returns funds for settled transactions when customer service agents detect disputes. The OpenAI Agents SDK executes this tool natively, logging the refund reason directly to your telemetry stream. For uncaptured funds, the agent executes `void_authorization` instead of processing a costly refund. This MCP Server integration ensures your model handles payment state transitions without human intervention.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the package using pip install openai-agents and initialize MCPServerStreamableHttp with your Vinkius endpoint. Pass the server instance inside the mcp_servers list when creating your Agent. Your API credentials stay secured on the Vinkius platform, leaving your local Python environment clean.

Yes, you configure guardrails directly in the SDK to inspect arguments before calling capture_order or create_order. The agent cannot execute these tools unless the payload matches your strict schema constraints and passes your validation checks.

Your agent calls suspend_subscription automatically when it detects delinquent customer accounts. The SDK traces this action in your dashboard, showing the exact tool parameters and the response from the payment gateway.

Run authorize_order to reserve the buyer's funds immediately. Once your inventory agent confirms stock is ready, a separate agent can execute capture_order to finalize the transaction.

The server runs in a zero-trust V8 Isolate sandbox, meaning no customer transaction details or subscription tokens are ever written to disk. All payment operations pass through ephemeral memory that is destroyed immediately after execution.

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