PayPal MCP server
PayPal's official remote MCP server brings invoicing, orders, and payments into agentic commerce.
PayPal MCP is PayPal's official remote server for agentic commerce. It exposes the PayPal agent toolkit so an AI agent can create and manage invoices, handle orders and payments, and work with the surrounding commerce primitives, with restricted tool visibility so users and the model only see the tools their token permits. A sandbox endpoint mirrors production so you can build and test against fake money before going live.
The production endpoint is https://mcp.paypal.com, with a Streamable HTTP transport at /http and an SSE transport at /sse. Authentication uses your PayPal client credentials, the client ID and secret from the PayPal Developer Dashboard, supplied through the authorization flow. Because real funds are involved, scope the credentials tightly and keep a human in the loop for irreversible actions.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"paypal": {
"type": "http",
"url": "https://mcp.paypal.com/http"
}
}
}claude mcp add --transport http paypal https://mcp.paypal.com/httpHeads up
- First tool call opens a browser to authorize.
Available tools
| Tool | Description |
|---|---|
| create_invoice | Creates a new invoice in the PayPal system. |
| list_invoices | Lists invoices with pagination and filtering options. |
| get_invoice | Retrieves the details of a specific invoice. |
| send_invoice | Sends an existing invoice to its recipient. |
| send_invoice_reminder | Sends a reminder for an existing invoice. |
| cancel_sent_invoice | Cancels a sent invoice. |
| generate_invoice_qr_code | Generates a QR code for an invoice. |
| create_order | Creates an order in the PayPal system from the provided details. |
| get_order | Retrieves the details of an order. |
| pay_order | Captures payment for an authorized order. |
| create_refund | Processes a refund for a captured payment. |
| get_refund | Retrieves the details of a specific refund. |
| create_product | Creates a new product in the PayPal catalog. |
| list_product | Lists products from the PayPal catalog. |
| show_product_details | Shows the details of a specific product. |
| create_subscription_plan | Creates a new subscription plan. |
| list_subscription_plans | Lists the subscription plans on the account. |
| show_subscription_plan_details | Shows the details of a specific subscription plan. |
| create_subscription | Creates a new subscription. |
| show_subscription_details | Shows the details of a specific subscription. |
| update_subscription | Updates an existing subscription. |
| cancel_subscription | Cancels an active subscription. |
| list_disputes | Retrieves a summary of disputes with optional filtering. |
| get_dispute | Retrieves detailed information about a specific dispute. |
| accept_dispute_claim | Accepts a dispute claim, resolving it in the buyer's favor. |
| create_shipment_tracking | Creates shipment tracking for a PayPal transaction. |
| get_shipment_tracking | Gets shipment tracking information for a shipment. |
| update_shipment_tracking | Updates shipment tracking information. |
| list_transaction | Lists transactions with pagination and filtering. |
| get_merchant_insights | Retrieves business intelligence metrics and analytics for a merchant. |
| search_product | Finds gift card products in the PayPal catalog (remote commerce tool). |
| create_cart | Opens a new shopping cart with specified items (remote commerce tool). |
| checkout_cart | Finalizes a shopping cart to complete a purchase (remote commerce tool). |
What you can do with it
Issue and track invoices
An agent drafts a PayPal invoice from a natural-language request and later reports on which invoices are outstanding.
Test commerce flows safely
Build against the sandbox endpoint with fake money, then flip to production once the order-to-capture flow behaves.
FAQ
- Is it free?
- The MCP server is free to connect; standard PayPal fees apply to real transactions it helps process.
- Does it support remote/OAuth?
- Yes. It is a remote server at https://mcp.paypal.com (Streamable HTTP at /http, SSE at /sse) authenticated with PayPal client credentials; a sandbox endpoint is available for testing.