Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Payments and finance - official PayPal server

PayPal MCP server

MCP server that lets merchants use PayPal APIs from MCP clients for invoices, orders and payments, refunds, disputes, shipment tracking, catalog products, subscriptions and reporting. Offered as a hosted remote server (sandbox and production) or a local npm package. PayPal hosts it at https://mcp.paypal.com/http, or you can run @paypal/mcp (npm) locally with OAuth or API key auth.

Last verified 15 tools4 sources

Install

Generic

JSON
{
   "mcpServers": {
     "paypal": {
       "command": "npx",
       "args": [
         "-y",
         "@paypal/mcp",
         "--tools=all"
       ],
       "env": {
         "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN",
         "PAYPAL_ENVIRONMENT": "SANDBOX"
       }
     }
   }
}

Tools

create_invoice
Create a new invoice in the PayPal system.
list_invoices
List invoices with pagination and filtering.
send_invoice
Send an existing invoice to the specified recipient.
create_order
Create an order in the PayPal system based on the provided details.
pay_order
Capture payment for an authorized order.
create_refund
Process a refund for a captured payment.
list_disputes
Retrieve a summary of all disputes with optional filtering.
accept_dispute_claim
Accept a dispute claim, resolving it in favor of the buyer.
create_shipment_tracking
Create shipment tracking information for a PayPal transaction.
create_product
Create a new product in the PayPal catalog.
create_subscription_plan
Create a new subscription plan.
cancel_subscription
Cancel an active subscription.
get_merchant_insights
Retrieve business intelligence metrics and analytics for a merchant.
list_transactions
List transactions with pagination and filtering.
search_product
Remote server only: find gift card products in the PayPal catalog.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Docs list production endpoints https://mcp.paypal.com/http (streamable HTTP) and https://mcp.paypal.com/sse (SSE), with sandbox equivalents on https://mcp.sandbox.paypal.com; the official MCP registry entry lists https://mcp.paypal.com/mcp instead of /http.
  • Remote auth is PayPal login (OAuth via mcp-remote) or a Bearer header built from Developer Dashboard client ID and secret.
  • Remote-only tools search_product, create_cart and checkout_cart currently cover gift cards only.
  • Local server requires Node.js 18+ and a PayPal access token; set PAYPAL_ENVIRONMENT to SANDBOX or PRODUCTION.
  • Docs examples target Claude Desktop; no client-specific snippets for Claude Code, Codex, Cursor or VS Code.
  • Remote SSE sandbox snippet from docs: {"mcpServers":{"paypal-mcp-server":{"command":"npx","args":["mcp-remote","https://mcp.sandbox.paypal.com/sse"]}}}.
  • No beta or preview label on the vendor page.

More MCP servers for payments and finance

Related reading

FAQ

What does the PayPal MCP server do?

MCP server that lets merchants use PayPal APIs from MCP clients for invoices, orders and payments, refunds, disputes, shipment tracking, catalog products, subscriptions and reporting. Offered as a hosted remote server (sandbox and production) or a local npm package. The vendor documents 15 tools, including create_invoice, list_invoices, send_invoice and create_order.

How do I add the PayPal MCP server to an MCP client?

PayPal documents a Generic config; copy it from the Generic section of this page.

Does the PayPal MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP, SSE, stdio. Status: GA, last checked October 17, 2026.

Sources

Last verified against 4 PayPal pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.