PayPal MCP Server
for AI Agents

Create a new PayPal order for payment processing

Show details for an order by ID

Update an order with CREATED or APPROVED status

Send or schedule a draft invoice to the recipient

List invoices with optional filtering and pagination

Retrieve details of a specific invoice by ID

Search for invoices using filters via POST /v2/invoicing/search-invoices. All filter fields go in the request body (not query params except page, page_size, total_required). An empty body (no filters) returns all invoices.

Fully update an existing invoice — use this to change payment terms, line items, recipient, amounts, or any other invoice field. This is a full replacement (PUT), not a partial update.

Delete a draft invoice by ID

Create a new catalog product

List catalog products with pagination

Retrieve details of a specific catalog product

Update a catalog product's description, category, image_url, or home_url fields using JSON Patch with "add" or "remove" operations. Returns 204 No Content on success.

Create a new subscription billing plan linked to a product, defining pricing, billing cycles, and payment preferences. For simple flat-rate plans use fixed_price, NOT VOLUME pricing. VOLUME and TIERED require 2+ tiers and quantity_supported=true.

List subscription billing plans with pagination

Retrieve details of a specific subscription plan

Create a new PayPal subscription that enrolls a subscriber into a billing plan, returning HATEOAS approval links the subscriber must visit to activate billing

Retrieve the full details of a specific PayPal subscription including its status, billing info, subscriber details, and plan configuration

Update an ACTIVE or SUSPENDED subscription using JSON Patch operations. Returns 204 No Content on success.

Create a batch payout to send payments to multiple recipients (max 15,000 items). sender_batch_id must be unique per 30 days even on failed attempts. Default to PAYPAL wallet — VENMO is US-only and unsupported in sandbox.

Retrieve details of a batch payout

List disputes with optional filtering by state, date range, or transaction ID. Supports page and page_size (1-50, default 10) for pagination. dispute_state accepts only ONE value per call.

Retrieve details of a specific dispute

Create a new webhook to receive event notifications. WARNING — PayPal sends a live HTTPS request to the URL at creation time and returns 400 if unreachable. Do NOT use example.com, localhost, or placeholder URLs.

List all webhooks for the app

Retrieve full details of a specific webhook by its ID

Update a webhook's URL or event types using JSON Patch. Only the "replace" operation is supported.

Delete a webhook by ID