PayPal MCP server

OfficialPayPal10Config last verified Jun 1, 2026

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

~/.claude.json
json
{
  "mcpServers": {
    "paypal": {
      "type": "http",
      "url": "https://mcp.paypal.com/http"
    }
  }
}
Or via CLI
bash
claude mcp add --transport http paypal https://mcp.paypal.com/http

Heads up

  • First tool call opens a browser to authorize.

Available tools

ToolDescription
create_invoiceCreates a new invoice in the PayPal system.
list_invoicesLists invoices with pagination and filtering options.
get_invoiceRetrieves the details of a specific invoice.
send_invoiceSends an existing invoice to its recipient.
send_invoice_reminderSends a reminder for an existing invoice.
cancel_sent_invoiceCancels a sent invoice.
generate_invoice_qr_codeGenerates a QR code for an invoice.
create_orderCreates an order in the PayPal system from the provided details.
get_orderRetrieves the details of an order.
pay_orderCaptures payment for an authorized order.
create_refundProcesses a refund for a captured payment.
get_refundRetrieves the details of a specific refund.
create_productCreates a new product in the PayPal catalog.
list_productLists products from the PayPal catalog.
show_product_detailsShows the details of a specific product.
create_subscription_planCreates a new subscription plan.
list_subscription_plansLists the subscription plans on the account.
show_subscription_plan_detailsShows the details of a specific subscription plan.
create_subscriptionCreates a new subscription.
show_subscription_detailsShows the details of a specific subscription.
update_subscriptionUpdates an existing subscription.
cancel_subscriptionCancels an active subscription.
list_disputesRetrieves a summary of disputes with optional filtering.
get_disputeRetrieves detailed information about a specific dispute.
accept_dispute_claimAccepts a dispute claim, resolving it in the buyer's favor.
create_shipment_trackingCreates shipment tracking for a PayPal transaction.
get_shipment_trackingGets shipment tracking information for a shipment.
update_shipment_trackingUpdates shipment tracking information.
list_transactionLists transactions with pagination and filtering.
get_merchant_insightsRetrieves business intelligence metrics and analytics for a merchant.
search_productFinds gift card products in the PayPal catalog (remote commerce tool).
create_cartOpens a new shopping cart with specified items (remote commerce tool).
checkout_cartFinalizes 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.
← Browse all payments servers