Hosting

Local and remote hosted

Transport

Local stdio; remote SSE and Streamable HTTP

Endpoint

Local process; no hosted endpoint documented

Authentication

Local server uses a PayPal access token via PAYPAL_ACCESS_TOKEN and PAYPAL_ENVIRONMENT. Remote setup uses PayPal OAuth/login consent; PayPal also documents client-credential token authorization. Do not expose client secrets or access tokens in chat or committed configuration.

Requirements

• PayPal merchant/developer account and access to the intended sandbox or production environment
• For local installation, Node.js 18 or later and the @paypal/mcp package invoked through npx
• For local mode, PayPal access token; use sandbox credentials for testing and production credentials only for live operations
• For remote mode, MCP client with supported HTTP transport and browser access to complete PayPal login and consent

Setup steps

1. For local mode, configure a stdio MCP server running `npx -y @paypal/mcp --tools=all` and provide PAYPAL_ACCESS_TOKEN and PAYPAL_ENVIRONMENT through a local secret manager or client environment configuration. Select SANDBOX for test credentials or PRODUCTION for live credentials.
2. For remote mode, choose the matching environment endpoint. Configure an MCP client for either SSE at /sse or Streamable HTTP at /http; examples use npx mcp-remote.
3. Save configuration and restart/reconnect the client. Complete PayPal login and authorize access when the browser consent flow opens.
4. Verify with a read-only operation such as listing products or invoices. Avoid using a create, refund, capture, dispute acceptance, subscription or checkout tool as a connection test.

Current PayPal Agent Toolkit README lists 44 standard tool names. The remote commerce flow has three additional feature-gated tools (search_product, create_cart, checkout_cart) documented by PayPal’s maintained toolkit skill reference; they require x-feature-flags: commerce:true and are remote-only. The catalog records both sets distinctly in the descriptions.

• create_invoice

  Create a new invoice in the PayPal system

  01
• list_invoices

  List invoices with optional pagination and filtering

  02
• get_invoice

  Retrieve details of a specific invoice

  03
• send_invoice

  Send an invoice to recipients

  04
• send_invoice_reminder

  Send a reminder for an existing invoice

  05
• cancel_sent_invoice

  Cancel a sent invoice

  06
• generate_invoice_qr_code

  Generate a QR code for an invoice

  07
• delete_invoice

  Permanently delete a draft or scheduled invoice

  08
• generate_invoice_number

  Generate the next invoice number available to the merchant

  09
• search_invoicing

  Search for invoices or recurring invoice series

  10
• update_invoicing

  Update an existing invoice or recurring invoice series (full-replacement)

  11
• cancel_invoice_auto_reminder

  Cancel all scheduled automatic reminders for an invoice

  12
• record_payment_for_invoice

  Record an external or manual payment against an invoice

  13
• record_refund_for_invoice

  Record a refund against an invoice

  14
• create_conditional_rules_for_invoice

  Create conditional rules for an invoice, such as an early payment discount or automatic cancellation date

  15
• create_recurring_series

  Create a recurring invoice series that automatically generates and sends invoices on a schedule

  16
• activate_recurring_series

  Activate a draft recurring invoice series

  17
• get_recurring_series

  Retrieve details of a specific recurring invoice series

  18
• cancel_recurring_series

  Cancel an active recurring invoice series

  19
• delete_recurring_series

  Delete a draft recurring invoice series

  20
• create_order

  Create an order in PayPal system based on provided details

  21
• get_order

  Retrieve the details of an order

  22
• pay_order

  Process payment for an authorized order

  23
• create_refund

  Process a refund for a captured payment.

  24
• get_refund

  Get the details for a specific refund.

  25
• list_disputes

  Retrieve a summary of all open disputes

  26
• get_dispute

  Retrieve detailed information of a specific dispute

  27
• accept_dispute_claim

  Accept a dispute claim

  28
• create_shipment_tracking

  Create a shipment tracking record

  29
• get_shipment_tracking

  Retrieve shipment tracking information

  30
• update_shipment_tracking

  Update shipment tracking information

  31
• create_product

  Create a new product in the PayPal catalog

  32
• list_products

  List products with optional pagination and filtering

  33
• show_product_details

  Retrieve details of a specific product

  34
• create_subscription_plan

  Create a new subscription plan

  35
• update_plan

  Update an existing plan

  36
• list_subscription_plans

  List subscription plans

  37
• show_subscription_plan_details

  Retrieve details of a specific subscription plan

  38
• create_subscription

  Create a new subscription

  39
• show_subscription_details

  Retrieve details of a specific subscription

  40
• update_subscription

  update an existing subscription

  41
• cancel_subscription

  Cancel an active subscription

  42
• list_transactions

  List transactions with optional pagination and filtering

  43
• get_merchant_insights

  Retrieve business intelligence metrics and analytics for a merchant

  44
• search_product

  Search PayPal product catalog for agentic commerce (remote-only; requires x-feature-flags: commerce:true).

  45
• create_cart

  Create a shopping cart for agentic commerce (remote-only; requires x-feature-flags: commerce:true).

  46
• checkout_cart

  Check out an agentic-commerce cart (remote-only; requires x-feature-flags: commerce:true).

  47

• The remote gift-card tools require the documented `x-feature-flags: commerce:true` header and are described as gift-card-only at the time checked.
• Many tools can create or change financial records, issue refunds, capture payments, accept disputes, or complete purchases. Review parameters and obtain explicit confirmation before write or destructive calls.
• Use sandbox endpoints and credentials for testing; production calls can have real financial effects.
• PayPal warns remote MCP may have client-specific issues, including a noted Cursor issue on Windows.
• No pricing or account-plan requirements were stated in the reviewed MCP documentation.

• The queue label says ?Agent Toolkit,? while the first-party guide calls the actual integration the PayPal MCP server and separately describes PayPal's broader agent toolkit. The record is named for the MCP implementation and preserves Agent Toolkit as its source context. Local and remote modes are documented by PayPal as the same MCP product with different deployment/authentication paths.

• official setup guide

  PayPal quickstart documents npm setup and sandbox/production remote endpoints, access-token/client credentials and supported transports.

• official tool reference

  PayPal maintained TypeScript toolkit reference currently enumerates 44 standard tools and their descriptions.

• official feature gated tool reference

  PayPal maintained AI Toolkit reference documents remote-only search_product, create_cart and checkout_cart tools gated by x-feature-flags: commerce:true.

Documentation checked 2026-10-28T13:56:00.000Z. Connection has not been runtime tested.