# PayPal MCP for AI Agents AI Agent Connect

> PayPal MCP. Manage e-commerce payments by orchestrating orders, processing captures, issuing refunds, and handling subscriptions through your AI client. It connects your agent directly to the PayPal E-Commerce API for real-time financial operations.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_TcUMHvXxbcZkyr0N9PJiSR99tWwOMnNESKFYxviq/ai-agent-connect
- **Tags:** checkout, refunds, subscription-billing, transaction-management, pci-compliance, api-integration

## Description

Equip your AI client with a direct line to the PayPal E-Commerce API. This Connector lets you move past the manual work of clicking through dashboards to handle payments, orders, and subscriptions through a simple chat interface. You can create new checkout orders, pull funds from authorized payments, and issue refunds against specific capture IDs without leaving your current workspace. It handles the complexity of subscription logic, too, letting you check if a customer is active, suspend a billing cycle, or cancel a plan entirely. This is a huge win for anyone tired of copy-pasting transaction IDs between different tabs. By using this Connector through the Vinkius catalog, you bring your financial operations into your agent's workflow. It's about turning a multi-step manual process into a single command that gets the job done.

## Tools

### authorize_order
Authorizes a payment for a specific order so you can hold the funds.

### create_order
Generates a new PayPal checkout order with specific amounts and currency.

### capture_order
Finalizes a payment by pulling the authorized funds into your merchant account.

### cancel_subscription
Stops an active recurring billing plan for a customer immediately.

### capture_authorization
Takes the funds from a previously authorized payment.

### get_order_details
Pulls the full history and status of a specific order ID.

### get_subscription
Retrieves the current status and billing details of a recurring subscription.

### refund_capture
Sends money back to a customer for a specific captured transaction.

### suspend_subscription
Pauses an active billing cycle without fully canceling the plan.

### void_authorization
Cancels a held payment authorization so the funds aren't pulled.

## Prompt Examples

**Prompt:** 
```
Can you refund order #99821 for the customer?
```

**Response:** 
```
**Refund Processed**

I've located the transaction for order #99821. Here are the details:

* **Status:** Captured
* **Amount:** $59.99
* **Action:** Refund issued successfully

The funds have been sent back to the customer's original payment method. Your records have been updated.
```

**Prompt:** 
```
Is the subscription for user 'jdoe_99' still active?
```

**Response:** 
```
**Subscription Status**

I checked the billing details for user `jdoe_99`:

| Plan Name | Status | Next Billing Date |
| :--- | :--- | :--- |
| Premium Monthly | **ACTIVE** | Oct 14, 2024 |

The user is currently on a valid billing cycle.
```

**Prompt:** 
```
Create a new order for $49.99 USD for a new customer.
```

**Response:** 
```
**New Order Created**

I've generated a new PayPal checkout order:

* **Order ID:** 98xx23
* **Amount:** $49.99 USD
* **Status:** Pending Authorization

You can share the checkout link with the customer to complete their purchase.
```

## Capabilities

### Create checkout orders
Generate new PayPal orders with specific amounts and currencies.

### Capture authorized payments
Finalize a transaction by pulling held funds into your merchant account.

### Issue transaction refunds
Send money back to a customer for a specific captured payment.

### Manage billing subscriptions
Suspend, cancel, or check the status of recurring payment plans.

### Verify order history
Retrieve full details and statuses for any specific order ID.

### Void payment authorizations
Release held funds that were never captured.

## Use Cases

### Refunding a customer order
A user asks for a refund on order #99821. The agent uses refund_capture to send the money back instantly without you opening a browser.

### Checking subscription status
A support rep asks if a user is still active. The agent uses get_subscription to confirm the billing cycle and provides the answer in the chat.

### Creating a test order
A dev wants to see a successful checkout flow. The agent uses create_order to generate a mock transaction for validation.

### Suspending a payment
A customer wants to take a break from their plan. The agent uses suspend_subscription to pause their next billing date.

## Benefits

- Stop manual dashboard jumping by using create_order to set up payments directly in your chat.
- Handle refunds faster with refund_capture to resolve customer issues in seconds.
- Manage recurring billing without clicking through menus by using cancel_subscription or suspend_subscription.
- Get instant status updates on any payment with get_order_details to keep your records accurate.
- Test your payment flows in staging by using authorize_order and capture_order to verify logic.

## How It Works

The bottom line is you get a direct way to manage your PayPal payments through your AI client.

1. Provide your PayPal Sandbox or Live Client ID and Secret to the Connector.
2. Grant your AI client permission to access your PayPal E-Commerce account.
3. Ask your agent to perform tasks like creating orders or checking subscription status.

## Frequently Asked Questions

**Can the PayPal MCP handle my refunds?**
Yes, it can process refunds for captured payments automatically. You just tell your agent which order to refund, and it handles the rest.

**Can I manage recurring subscriptions with the PayPal MCP?**
Yes, you can use it to pause, cancel, or check the status of any recurring billing plan through your AI client.

**Does the PayPal MCP work for testing my store?**
Yes, you can use your PayPal Sandbox credentials to test checkout flows and order creation without moving real money.

**Can my agent check if a payment was successful?**
Yes, the agent can pull the full history and status of any specific order to confirm if a payment was completed.

**Is the PayPal MCP safe for e-commerce?**
It connects directly to the official PayPal E-Commerce API, ensuring your financial operations stay within PayPal's secure infrastructure.

**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.