PayPal MCP. Control the entire payment lifecycle in your chat window.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
PayPal MCP Server manages your e-commerce payments through your AI client. It lets you programmatically create orders, reserve funds via `authorize_order`, process captures, issue refunds using `refund_capture`, and manage recurring subscriptions—all from a single chat interface.
What your AI agents can do
Authorize order
Reserves funds on a customer's payment method for an order amount.
Cancel subscription
Immediately terminates an active recurring subscription.
Capture authorization
Finalizes the transaction by moving reserved funds into the merchant account.
Starts a new PayPal order, or fetches specific details about an existing order ID.
Reserves money on the customer's card for a specified amount, pending final capture.
Finalizes the payment by moving reserved funds from the authorization to the merchant account.
Issues a refund against a previously captured payment using a specific Capture ID.
Retrieves details, suspends service, or cancels recurring billing accounts.
Cancels a reserved payment amount that was never captured.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
PayPal MCP Server: 10 Tools for Payment Control
Manage every stage of e-commerce payment flow—from creating the initial order to processing refunds against captured funds.
019d75f0authorize order
Reserves funds on a customer's payment method for an order amount.
019d75f0cancel subscription
Immediately terminates an active recurring subscription.
019d75f0capture authorization
Finalizes the transaction by moving reserved funds into the merchant account.
019d75f0capture order
Processes and finalizes payment for a new checkout order.
019d75f0create order
Generates a brand new, structured PayPal checkout order ID.
019d75f0get order details
Retrieves all details for a specific PayPal Order ID.
019d75f0get subscription
Fetches the current status and billing metadata for a recurring subscription.
019d75f0refund capture
Issues a refund against an already captured transaction ID.
019d75f0suspend subscription
Temporarily halts billing and services for an active subscription account.
019d75f0void authorization
Releases reserved funds when a payment authorization is no longer needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with PayPal, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
This server lets your AI client manage every part of your e-commerce payment lifecycle through PayPal's official API. You don't gotta leave your chat window to process payments, issue refunds, or handle recurring billing. It's built for transactional accuracy, giving you direct access to the core functions that move money and track orders.
Creating and Querying Orders
To start a sale, use create_order to generate a new, structured PayPal checkout order ID. You can then check on any existing transaction by calling get_order_details, which pulls all relevant information for that specific Order ID. This gives you immediate visibility into whether an order is pending or finalized.
Authorizing and Capturing Funds
The payment process starts when you reserve the money. You use authorize_order to hold funds on a customer's payment method for a specified amount; this keeps the money locked down until you're ready to finalize it. When you've confirmed the goods shipped or the service was delivered, you run with the finalization.
Use capture_authorization to move those reserved funds into your merchant account, completing the sale. If you generate an order but never complete the purchase, you can call void_authorization to release the reserved money back to the customer's card.
Handling Refunds and Adjustments
If a return happens or a payment needs correcting, you use refund_capture. This function issues a refund directly against a specific Capture ID, ensuring the credit goes back to the customer for an already processed transaction. It’s your mechanism for maintaining financial accountability across all refunds.
Managing Subscriptions and Billing Status
For recurring revenue, you've got full control over subscription lifecycles. You can use get_subscription to fetch the current status and detailed billing metadata for any active account. If a customer needs a break, you have two options: you can temporarily stop their service and payments by calling suspend_subscription, or if the relationship is ending, you immediately terminate all recurring charges using cancel_subscription.
These tools let you manage the entire state of billing, from active to suspended to terminated.
How PayPal MCP Works
- 1 Subscribe to the server and provide your specific PayPal Sandbox or Live Client ID, along with your Secret credentials.
- 2 Your AI client sends an explicit financial payload (e.g., asking to
create_orderfor $100). - 3 The tool executes the API call against PayPal's system and returns a verified status code and transaction ID.
The bottom line is that you get full control over your payment flow by simply telling your agent what needs to happen, without writing boilerplate API code.
Who Is PayPal MCP For?
This is for backend developers and financial ops engineers who hate the manual cycle of logging into a dashboard, checking transaction IDs in one place, and then executing follow-up actions in another. If you spend time reconciling payment disputes or building complex order logic, this saves hours.
Uses the server to write tests that validate full checkout flows (create -> authorize -> capture) before deploying code.
Runs scripts to audit account activity, specifically querying get_order_details or issuing bulk refunds via refund_capture after a dispute.
Needs to programmatically check if a customer's subscription is 'Active' using get_subscription, or suspend service immediately using suspend_subscription.
What Changes When You Connect
- Manage disputes faster. Instead of manual lookups, use
get_order_detailsto instantly verify an order's status and find the necessary transaction IDs. - Handle cancellations gracefully. Don't just delete records; call
void_authorizationwhen a payment reservation is incomplete, keeping your ledger clean. - Control recurring revenue. Use
get_subscriptionto check if a user’s billing cycle is 'Active', and then usesuspend_subscriptionif they hit a service limit. - Automate refunds securely. When a refund is needed, calling
refund_captureagainst the specific Capture ID ensures you are always working with the correct financial record. - Simplify initial checkout. Use
create_orderto generate the necessary payment object upfront, giving your agent a starting point for the entire transaction flow. - Build robust test environments. You can simulate full transactions—
authorize_orderthencapture_authorization—without touching live money.
Real-World Use Cases
Handling an Immediate Refund
A customer claims they were double-billed. Instead of logging into the admin panel, you ask your agent to run get_order_details using the Order ID provided by the customer. Once verified, the agent executes refund_capture against the captured payment ID, confirming the refund instantly.
Takedown for Suspended Accounts
A user’s account violates terms. The standard workflow is to manually disable them and check billing status. With the MCP Server, you run get_subscription first; if it's active, you execute suspend_subscription immediately via a single command.
Testing an Abandoned Cart Flow
Your QA team needs to test what happens when a user authorizes payment but never completes the purchase. They run authorize_order, confirm the funds are reserved, and then use void_authorization to cleanly release the held amount.
Auditing Past Transactions
A financial auditor needs proof of a specific $50 payment from last month. You ask your agent to query for all orders on that date, use get_order_details on the relevant Order ID, and then check if the funds were captured using capture_order.
The Tradeoffs
Assuming one API call is enough
Calling only create_order and assuming the payment goes through. This fails because PayPal requires a separate, authorized step to reserve funds before capture.
→
You must sequence the steps: first run authorize_order to reserve the money. Then, if everything is good, you call capture_authorization. Never skip the reservation step.
Using generic payment tools
Trying to refund a payment using a basic API wrapper that doesn't handle transaction IDs correctly. This results in ambiguous failure logs and potential over-refunding.
→
Always use refund_capture and ensure you pass the specific Capture ID obtained from previous steps like get_order_details. The tool requires this exact reference.
Handling subscriptions manually
Writing complex conditional logic to check if a user is eligible for suspension, requiring multiple database checks.
→
Use the built-in tools. First, call get_subscription to verify the current status and next billing date. Then, use suspend_subscription when conditions are met.
When It Fits, When It Doesn't
Use this PayPal MCP Server if your job requires managing a payment state machine: moving money from 'Pending' -> 'Authorized' -> 'Captured' -> 'Refunded'. You need the AI agent to handle complex sequencing (e.g., Authorize, wait 1 hour, Capture, then potentially Void). Don't use this if you just need to read static data; for that, simple API calls are fine.
However, don't rely on it for accounting ledger entries—it manages the transfer, not the final bookkeeping. If your goal is simply retrieving a single order ID or checking basic status without running a multi-step process, using standard direct API clients might be simpler. This tool excels when you need to coordinate 3+ steps (e.g., get_subscription -> check status -> suspend_subscription).
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Processing payments today is an assembly line of dashboards and APIs.
Right now, a single payment dispute requires you to jump between the main PayPal dashboard, your internal CRM, and often a separate ledger system. You copy the Order ID from one place, paste it into another API call, wait for the response, then manually determine if you need to initiate `refund_capture` or if you just needed to void a previous authorization.
With this MCP Server, all that happens in chat. You tell your agent: 'Refund payment X.' It runs through the necessary checks (`get_order_details`, verifies capture status) and executes the `refund_capture` tool—all in one go. The complexity disappears.
PayPal MCP Server: Full control over payments, captures, and subscriptions.
The old way meant writing dedicated microservices for every transaction path: one service for refunds, another just for subscription checks. Each required error handling, retries, and state tracking—massive technical debt.
Now, you call `cancel_subscription` or run `capture_order`. The server manages the PayPal API structure, error codes, and necessary sequencing. You get a reliable financial transaction result without writing boilerplate code.
Common Questions About PayPal MCP
How do I start a new payment using create_order? +
You call create_order with the required line items and total amount. This generates the unique Order ID needed for all subsequent steps, like authorization.
What is the difference between authorize_order and capture_authorization? +
authorize_order reserves funds (like holding a credit card); it doesn't move money. capture_authorization actually moves those reserved funds into your merchant account.
Can I refund an order without knowing the capture ID? +
No. You must first use get_order_details to find the specific Capture ID linked to that Order ID before running refund_capture. The tool requires this precise identifier.
How do I check if a subscription is still active using get_subscription? +
You run get_subscription and inspect the returned metadata fields. This tells you the current status (e.g., 'ACTIVE' or 'SUSPENDED') and when the next billing cycle hits.
When should I use void_authorization? +
void_authorization is for payments that were authorized but never captured—meaning the transaction fell apart before completion. It safely releases the reserved funds without needing a refund process.
What credentials must I provide to use the `capture_order` tool? +
You must configure your PayPal Sandbox or Live Client ID and Secret parameters. The agent uses these explicit keys for authentication, ensuring every payment capture payload executes securely against your designated merchant account.
How do I temporarily pause a recurring billing cycle using `suspend_subscription`? +
You call the suspend_subscription tool with the subscription ID. This immediately halts all future billing cycles without canceling the user's account, allowing you to easily resume service later.
If I need a full audit trail of an order, how do I use `get_order_details`? +
Use get_order_details and input the specific Order ID. This returns a complete record showing every status change—from creation through authorization to capture or void—essential for compliance checks.
Can I switch explicitly between testing (Sandbox) and Live operational arrays natively? +
Yes. The environment parameters expose an explicitly bounded flag globally allowing configuration arrays parsing seamlessly switching requests between Sandbox limits and Live endpoints. Ensure your keys correspond properly.
Is it possible to list explicit mass payment histories filtering natively across accounts? +
This particular structural node maps explicit order manipulation limits. Operations resolving broad search queries or complex un-bounded transaction logs aren't exposed natively in this immediate abstraction scope for precise object handling.
Which parameter natively identifies bounds when generating refunds? +
Proper financial refunds are mapped utilizing strictly captured payment node structures. You must pass the specific Capture ID explicitly retrieved from logging the 'capture_order' action properly, not just initial limit bounds.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Recurly
Equip your AI to directly manage subscriptions, billing accounts, and invoices within your Recurly ecosystem without shifting interfaces.
Mollie
Accept online payments across Europe with a payment gateway that supports iDEAL, credit cards, PayPal, and local methods seamlessly.
Griffin
Manage your banking & fintech operations via Griffin — list accounts, monitor transactions, and handle verifications via AI.
You might also like
InvestorLift
Automate real estate deal sourcing via InvestorLift — list marketplace deals, manage your buy box criteria, and message sellers directly from any AI agent.
DocRaptor
Convert HTML to professional PDFs and Excel spreadsheets using the high-quality Prince XML engine.
Beds24
Manage properties, bookings, rooms, calendar, availability, and pricing for your Beds24 channel manager through natural conversation.