PayPal MCP Server (Official)
paypal-mcp
PayPal's official MCP server (npx @paypal/mcp): 28 dedicated tools across invoices, products, subscriptions, orders, disputes, shipment tracking, transactions and refunds. Explicit per-operation tools; auth via a PayPal access token (client-credentials).
When to use
Agents handling PayPal invoicing, subscriptions, orders, disputes or refunds with explicit per-operation tools and sandbox support.
When not to use
Tight context budgets — 28 tool definitions cost ~8.6k tokens to load; or flows needing idempotent creates (creates not verified idempotent).
Premium · managed ✦
We run it in production for you — idempotent writes, automatic retries, full visibility.
Run it for me →What you need to integrate
Authentication
oauth2 · documented · token refresh
Requirements
- Rate limits: documented
- Tool-definition budget: 8,584 tok
Setup checklist
- Register an OAuth2 app and obtain client credentials.
- Authorize the required scopes.
- Configure token refresh for long-running sessions.
- Set environment variables: PAYPAL_MCP_TOKEN.
Env: PAYPAL_MCP_TOKEN
Docs & known issues
Evaluation
Measured 2026-06-28 (sandbox): update-type writes returned stable results on retry; creates were not idempotent. 8 write probes (5 create-like, 3 update-like).
Works with
- –
- –
- –
- –
- –
- –
- –
- –
- –
- –
- –
- –
See the full compatibility list.