create_product
Create a new product in the PayPal catalog.
LABSCO SUMMARY
A sandbox endpoint at a parallel address is the single most important feature for anything that moves money.
An agent learning a payments API against production is a bad idea. PayPal's sandbox is a different host with the same shape, so the same client config works with one URL changed — which means the rehearsal is genuinely cheap. Do it: an invoice created by mistake is a customer conversation.
What it is
PayPal's hosted endpoint for merchant operations, with a separate sandbox address for testing.
What you get
The merchant toolset, including invoice creation; PayPal's agent-tools catalogue is the full reference.
Requirements
Client credentials from the PayPal Developer Dashboard, exchanged for an access token, then a consent step. Test in PayPal's sandbox before going live, and while you do, connect to the sandbox address, https://mcp.sandbox.paypal.com/sse, not the live one.
Setup effort
Paste a URL, then authorize — add the endpoint to your client, then approve the OAuth consent screen
USE CASES
01
Rehearsing before going live
Point the same client at the sandbox host, then change one URL.
02
Creating an invoice
Merchant operations from the conversation rather than the dashboard.
33 tools
Listed in project docs. Your client may show a different list.
list_product
List products from the PayPal catalog. Pagination options are available.
show_product_details
Show details of a specific product from the PayPal catalog.
list_disputes
Retrieve a summary of all disputes with optional filtering.
get_dispute
Retrieve detailed information about a specific dispute.
accept_dispute_claim
Accept a dispute claim, resolving it in favor of the buyer.
create_invoice
Create a new invoice in the PayPal system.
list_invoices
List invoices. Pagination and filtering options are available.
get_invoice
Retrieve details about a specific invoice.
send_invoice
Send an existing invoice to the specified recipient.
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.
create_order
Create an order in the PayPal system based on the provided details.
create_refund
Process a refund for a captured payment.
get_order
Get details of a specific payment.
get_refund
Get the details for a specific refund.
pay_order
Capture payment for an authorized order.
get_merchant_insights
Retrieve business intelligence metrics and analytics for a merchant, filtered by start date, end date, insight type, and time interval.
list_transaction
List all transactions. Pagination and filtering options are available.
create_shipment_tracking
Create shipment tracking information for a PayPal transaction.
get_shipment_tracking
Get shipment tracking information for a specific shipment.
update_shipment_tracking
Update shipment tracking information for a specific shipment.
cancel_subscription
Cancel an active subscription.
create_subscription
Create a new subscription.
create_subscription_plan
Create a new subscription plan.
list_subscription_plans
List subscription plans.
show_subscription_details
Show details of a specific subscription.
show_subscription_plan_details
Show details of a specific subscription plan.
update_subscription
Update an existing subscription.
search_product
Find gift card products in the PayPal catalog. This tool searches the catalog for gift cards that meet your criteria. It returns product information that includes pricing, availability, and purchase options.
create_cart
Open a new shopping cart with specified items and shipping preferences. This tool creates a new shopping cart with the selected gift cards. It handles cart initialization, item configuration, and preparing the cart for checkout.
checkout_cart
Finalize a shopping cart to complete the purchase process. This tool processes the final checkout for a configured shopping cart using PayPal for payment. It handles payment processing, transaction validation, and purchase confirmation.
BEFORE YOU INSTALL
What to know first
Tools you get
33 tools named in the project's documentation.
Requires
- an MCP client that can reach a remote endpoint
- OAuth, or a bearer access token obtained from client credentials in the PayPal Developer Dashboard
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Add the endpoint to your client, then approve the OAuth consent screen.
Server setup
ENDPOINT URL
https://mcp.paypal.com/sseRequirements
- OAuth, or a bearer access token obtained from client credentials in the PayPal Developer Dashboard
MCP Clients
Claude Desktop — Local
To run the MCP server locally, you need Node.js v18 or later. In Claude, for example, you add the following configuration to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).
CLAUDE DESKTOP — LOCAL · JSON
{
"mcpServers": {
"paypal": {
"command": "npx",
"args": [
"-y",
"@paypal/mcp",
"--tools=all"
],
"env": {
"PAYPAL_ACCESS_TOKEN": "<YOUR_PAYPAL_ACCESS_TOKEN>",
"PAYPAL_ENVIRONMENT": "SANDBOX"
}
}
}
}<YOUR_PAYPAL_ACCESS_TOKEN> is a PayPal access token. Set PAYPAL_ENVIRONMENT to SANDBOX for testing or PRODUCTION for live use. To get a token, send your app's client ID and secret from the PayPal Developer Dashboard to https://api-m.sandbox.paypal.com/v1/oauth2/token with grant_type=client_credentials (for live use, https://api-m.paypal.com/v1/oauth2/token). Sandbox tokens last 3 to 8 hours and live ones 8 hours, so request a new token when yours runs out.
