# PayPal MCP Server (Agent Toolkit)
> PayPal's MCP integration provides local and hosted ways for merchants to connect AI clients to PayPal catalog, dispute, invoice, payment, reporting, shipment, and subscription tools. The hosted server also documents gift-card search and checkout tools.
Canonical: https://www.mcpfolio.com/servers/paypal-agent-toolkit
Last updated: 2026-10-28
## Catalog record

- Publisher: PayPal
- Categories: development, search, finance

## Website

https://developer.paypal.com/ai-tools/get-started/

## Transports

Local stdio; remote SSE and Streamable HTTP

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

## Tools

- **create_invoice**: Create a new invoice in the PayPal system
- **list_invoices**: List invoices with optional pagination and filtering
- **get_invoice**: Retrieve details of a specific invoice
- **send_invoice**: Send an invoice to recipients
- **send_invoice_reminder**: Send a reminder for an existing invoice
- **cancel_sent_invoice**: Cancel a sent invoice
- **generate_invoice_qr_code**: Generate a QR code for an invoice
- **delete_invoice**: Permanently delete a draft or scheduled invoice
- **generate_invoice_number**: Generate the next invoice number available to the merchant
- **search_invoicing**: Search for invoices or recurring invoice series
- **update_invoicing**: Update an existing invoice or recurring invoice series (full-replacement)
- **cancel_invoice_auto_reminder**: Cancel all scheduled automatic reminders for an invoice
- **record_payment_for_invoice**: Record an external or manual payment against an invoice
- **record_refund_for_invoice**: Record a refund against an invoice
- **create_conditional_rules_for_invoice**: Create conditional rules for an invoice, such as an early payment discount or automatic cancellation date
- **create_recurring_series**: Create a recurring invoice series that automatically generates and sends invoices on a schedule
- **activate_recurring_series**: Activate a draft recurring invoice series
- **get_recurring_series**: Retrieve details of a specific recurring invoice series
- **cancel_recurring_series**: Cancel an active recurring invoice series
- **delete_recurring_series**: Delete a draft recurring invoice series
- **create_order**: Create an order in PayPal system based on provided details
- **get_order**: Retrieve the details of an order
- **pay_order**: Process payment for an authorized order
- **create_refund**: Process a refund for a captured payment.
- **get_refund**: Get the details for a specific refund.
- **list_disputes**: Retrieve a summary of all open disputes
- **get_dispute**: Retrieve detailed information of a specific dispute
- **accept_dispute_claim**: Accept a dispute claim
- **create_shipment_tracking**: Create a shipment tracking record
- **get_shipment_tracking**: Retrieve shipment tracking information
- **update_shipment_tracking**: Update shipment tracking information
- **create_product**: Create a new product in the PayPal catalog
- **list_products**: List products with optional pagination and filtering
- **show_product_details**: Retrieve details of a specific product
- **create_subscription_plan**: Create a new subscription plan
- **update_plan**: Update an existing plan
- **list_subscription_plans**: List subscription plans
- **show_subscription_plan_details**: Retrieve details of a specific subscription plan
- **create_subscription**: Create a new subscription
- **show_subscription_details**: Retrieve details of a specific subscription
- **update_subscription**: update an existing subscription
- **cancel_subscription**: Cancel an active subscription
- **list_transactions**: List transactions with optional pagination and filtering
- **get_merchant_insights**: Retrieve business intelligence metrics and analytics for a merchant
- **search_product**: Search PayPal product catalog for agentic commerce (remote-only; requires x-feature-flags: commerce:true).
- **create_cart**: Create a shopping cart for agentic commerce (remote-only; requires x-feature-flags: commerce:true).
- **checkout_cart**: Check out an agentic-commerce cart (remote-only; requires x-feature-flags: commerce:true).

## Sources

- [official_setup_guide](https://raw.githubusercontent.com/paypal/agent-toolkit/main/typescript/README.md)
- [official_tool_reference](https://github.com/paypal/agent-toolkit/blob/main/typescript/README.md)
- [official_feature_gated_tool_reference](https://github.com/paypal/AI-Toolkit/blob/main/skills/paypal-best-practices/references/mcp-tools.md)

## Setup

Use the interactive setup panel on [the detail page](https://www.mcpfolio.com/servers/paypal-agent-toolkit) to view instructions for each supported client.