PayPal Agent Toolkit MCP: Documentation
Updated:
Connection
npx -y @paypal/mcp --tools=all (stdio). Env vars PAYPAL_CLIENT_ID and PAYPAL_CLIENT_SECRET from the PayPal Developer Dashboard — the server exchanges them for a bearer token via OAuth client credentials itself; or supply a ready PAYPAL_ACCESS_TOKEN. The --tools= flag can enable just the groups you need (e.g. invoices,orders) instead of everything. For testing, pass sandbox: true in the configuration — all operations then run against PayPal Sandbox instead of LIVE.
Tools
27+ tools across 6 groups:
- Invoices:
create_invoice,list_invoices,get_invoice,send_invoice,send_invoice_reminder,cancel_sent_invoice,generate_invoice_qr_code. - Payments:
create_order,get_order,pay_order,create_refund,get_refund. - Disputes:
list_disputes,get_dispute,accept_dispute_claim. - Shipping:
create_shipment_tracking,get_shipment_tracking,update_shipment_tracking. - Catalog:
create_product,list_products,show_product_details. - Subscriptions:
create_subscription_plan,list_subscription_plans,create_subscription,update_subscription,cancel_subscription. - Reporting:
list_transactions,get_merchant_insights.
Agent flow
"Invoice a client for $450 and send the payment link", "accept the dispute on order #4471 and issue a refund", "set up a new $19/month subscription plan", "show me merchant insights for the quarter".
Important
PayPal keys give direct access to the seller's money: an agent with the full tool set can issue refunds and accept disputes. Start in the sandbox environment with a limited --tools= set, and move to LIVE only after your flows are verified.
Pricing
The MCP server and the @paypal/agent-toolkit package are free (open source); payment processing is billed at PayPal's regular rates.