PayPal MCP for AI Agents. Control payments, orders, and subscriptions through chat.
PayPal MCP manages your entire e-commerce payment lifecycle through AI actions. You can programmatically create orders, authorize funds, capture payments, issue refunds, and manage complex recurring subscriptions—all without leaving your chat interface. It gives your agent the power to handle everything from initial checkout flows to final ledger adjustments using secure PayPal API tools.
Give Claude and any AI agent real-world access
You can initiate a checkout process by creating a structured order record before any money moves.
The MCP allows you to authorize funds against an order, capture them later, or void the authorization entirely.
You can issue a refund for any payment that has already been captured, requiring only the correct transaction ID.
The tool lets you fetch details about recurring billing setups, and even suspend or cancel active plans.
You can pull full details for any specific order using its unique identifier.
Ask an AI about this
Waiting for input…
What AI agents can do with PayPal MCP: 10 Tools for Payment Control
These ten tools let you handle the full spectrum of financial transactions—from setting up an order to voiding a payment or managing recurring billing cycles.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using PayPal MCPAuthorize Order
Creates a temporary hold on funds for an order, confirming the customer has paid before shipping goods.
Capture Order
Completes a payment by moving the authorized funds from the holding status to active...
Create Order
Sets up a brand new, structured PayPal checkout order ready for authorization and...
Cancel Subscription
Immediately stops an active recurring billing cycle when a customer requests account...
Capture Authorization
Activates funds that were previously authorized on an order, moving them into the...
Get Order Details
Retrieves all historical and current details for a specific order ID.
Get Subscription
Pulls the full metadata, status, and next billing date for any recurring subscription plan.
Refund Capture
Issues a refund against a payment that has already been processed (captured) using...
Suspend Subscription
Temporarily pauses an active subscription service, useful for maintenance or account...
Void Authorization
Reverses a payment hold that was placed on an order but never converted into a final...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
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 each 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 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
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 each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Dealing with payment reconciliation is always a nightmare. Solved with Vinkius AI Gateway
Today, handling a complex order means hopping between three different dashboards: the checkout page for initial authorization, the billing portal to check subscription status, and the finance system just to process a refund. You end up copying IDs, switching tabs, and waiting for confirmation emails—it’s slow and error-prone.
With this MCP, you keep it all in your chat interface. Need to confirm an order? Ask for `get_order_details`. Want to cancel service? Run the `cancel_subscription` tool. The system handles the API calls; you just get the final status confirmation right where you are.
PayPal MCP: Complete Payment Lifecycle Control
The manual process of running payments involves separate steps for creation, authorization, and capture. You have to treat them as three distinct transactions in different systems.
Now, the entire payment flow is encapsulated. Your agent manages `create_order`, runs `authorize_order` when needed, and completes it with `capture_order`. The complexity disappears; you just get a confirmed payment status.
What your AI can actually do with this
This MCP lets you control every step of an e-commerce transaction directly through your AI client. Need to process a refund because something was wrong with shipping? You can execute that immediately, provided you have the correct capture ID. Want to check if a customer's monthly billing cycle is active before sending a service reminder? This connection pulls the exact details on recurring subscriptions and their next billing date.
It handles payment creation, authorizing funds up front, capturing them later, or voiding the whole thing if the order never ships. Because Vinkius hosts this connector, you get access to all these capabilities in one place—you just tell your agent what needs fixing, and it runs the correct financial command.
019d75f0-82cc-7141-a274-0ebbc6c3a35d Here's how it actually works
The bottom line is that you use your AI agent to translate natural language commands into secure, structured payment API calls.
First, you subscribe to the PayPal MCP and input your Sandbox or Live Client ID along with your secret credentials.
Next, you instruct your AI agent on the specific financial action needed—for example, 'Capture payment for order XYZ' or 'Cancel subscription ABC'.
The MCP sends the request to PayPal, which executes the command and returns a confirmation status and any necessary transaction IDs.
Who is this actually for?
This MCP solves the problem of needing real-time financial control without logging into a separate payments dashboard. It’s for roles that live in the intersection of engineering and finance.
You write tests that simulate checkout flows, allowing you to validate order creation and capture logic locally before merging code.
When a complex ledger error pops up, you can issue explicit refunds or verify the status of multiple captured payments across different endpoints.
A customer calls asking if their service is still active. You query the subscription details to confirm its precise status and next billing date instantly.
What Changes When You Connect
Don't manually check statuses. Use get_subscription to instantly verify if a customer’s billing cycle is 'Active' or what their next invoice date will be.
Eliminate payment bottlenecks by using create_order first, then running authorize_order, and finally capture_order—all in one chat session, simulating the entire checkout flow.
When things go wrong, use refund_capture to issue refunds directly against a specific capture ID. This replaces needing to jump into the web portal just to process a return.
Stop losing time on failed orders. If you authorize funds but realize nothing is happening, run void_authorization to safely release those held funds.
Manage account changes by using suspend_subscription or cancel_subscription, allowing your agent to handle service deactivation immediately when needed.
See it in action
Processing a late return payment
A customer returns an item and needs money back. Instead of emailing finance with the transaction ID, they ask their agent: 'Refund capture for Order 98xx23.' The agent runs refund_capture instantly, confirming the credit.
Validating a pilot program rollout
A software engineer needs to test subscription logic. They use get_subscription and then run suspend_subscription on a test account ID to ensure the suspension process works before deploying it widely.
Handling abandoned carts with pre-paid holds
A user authorized funds but left the site. The team needs to confirm if they should proceed with payment or cancel the hold. They run void_authorization against the order ID, safely releasing the money.
Diagnosing recurring billing issues
A customer calls about a failed charge. The agent runs get_order_details to check payment history and then uses get_subscription to see if the account status is correctly marked as 'Active' or suspended.
The honest tradeoffs
What to watch out for, and the recommended way to handle each one.
Trying to refund without an ID
Saying: 'Refund this customer for last month.' The agent fails because it doesn't know which specific payment record to target.
You must always use refund_capture and provide the exact Capture ID. The tool requires that specific reference point to process the refund securely.
Assuming funds are available
Running a capture command without first authorizing the payment. This results in an immediate failure because no initial hold was placed.
Always run authorize_order first to place the necessary hold on funds, and only then execute capture_order when ready.
Trying to modify a closed order
Attempting any payment action (like refunding) against an order that has already been voided or completed months ago. The API will reject the command.
Always use get_order_details first to check the current, verifiable status of the order before attempting any modification.
When It Fits, When It Doesn't
Use this MCP if your primary need is managing the financial mechanics and lifecycle of payments. If you are handling a payment flow—whether it's a single purchase or a multi-year subscription—you need tools like authorize_order, capture_order, and refund_capture. Don't use this, though, if you just need to read generic business data that isn't tied to money. For instance, if you only need to know the user's name or email for a marketing list, an identity management tool is better. This MCP strictly controls financial state changes; it doesn't manage inventory levels or shipping tracking numbers.
Questions you might have
How do I check the current status of an active subscription using PayPal MCP? +
Use the get_subscription tool. This pulls all metadata, letting you see if the account is 'ACTIVE', suspended, or what day its next billing cycle starts.
Can I refund payments with PayPal MCP if they are already captured? +
Yes. You must use refund_capture and provide the specific Capture ID for the payment you want to reverse. This ensures the funds come from the correct source.
What is the difference between authorize_order and create_order? +
create_order sets up the empty container (the order record). authorize_order uses that container to place a temporary hold on funds, which is the first step toward payment.
Do I need to use PayPal MCP for every type of refund? +
If the payment was processed through PayPal and has been captured, yes. The refund_capture tool is designed specifically to manage these financial adjustments.
How does void_authorization work in PayPal MCP? +
void_authorization reverses a temporary hold on funds. Use this if you authorized the payment but then decided the transaction should never happen and need to release the money back to the customer.