PayPal Agent Toolkit
PayPal's official agent toolkit: an MCP server and SDK for invoices, orders, subscriptions, refunds and disputes
Install
{
"mcpServers": {
"paypal": {
"command": "npx",
"args": [
"-y",
"@paypal/mcp",
"--tools=all"
],
"env": {
"PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN",
"PAYPAL_ENVIRONMENT": "SANDBOX"
}
}
}
}The same config works in Cursor and Cline. Use PAYPAL_ENVIRONMENT=PRODUCTION for live payments.
This is third-party code. Review the repository files before installing.
What it does
The repository holds an MCP server and a library that exposes PayPal APIs to agents as functions. The agent creates and sends invoices, including recurring ones, places orders and refunds, and manages products and subscription plans. It also reviews disputes and transactions, adds shipment tracking and pulls merchant metrics. The library plugs into the OpenAI Agents SDK, LangChain and Vercel AI SDK, and the config lets you enable only the actions you need.
Who it is for. For merchants and developers who take payments through PayPal outside Russia.
Good fit when
- You need to issue and track PayPal invoices from an agent
- You need to review open disputes and transactions
- You want PayPal payments in your own agent built on AI SDK or LangChain
Not a fit when
- Your business operates in Russia, where PayPal does not process payments
- The agent must not handle money without human review
Example request
Show my unpaid PayPal invoices and send reminders for the oldest onesLimitations
Requires a PayPal Developer account for the sandbox and a Business account for production. PayPal does not serve users in Russia. The local server takes an access token that expires after a few hours and must be refreshed. The remote server signs in with a PayPal account. PayPal asks users to verify model output themselves.
How to disable. Remove the paypal block from the MCP config, restart the client and revoke the token or app access in the PayPal Developer Dashboard.
MCP
- Transport
- stdio, sse, http
- Authentication
- OAuth
| Environment variables | |
|---|---|
| PAYPAL_ACCESS_TOKEN required, secret | PayPal access token for the local server |
| PAYPAL_ENVIRONMENT | SANDBOX or PRODUCTION, default SANDBOX |
Security check
- Processes order payments and refunds
- Sends invoices to customers and changes subscriptions
README in short
The README lists tools by group: invoices, payments, disputes, shipping, catalog, subscriptions and reporting. It shows installing @paypal/agent-toolkit for TypeScript, picking allowed actions and sandbox mode. The TypeScript package README covers running the MCP server via npx @paypal/mcp and a Claude Desktop config. Getting an access token is explained step by step.
FAQ
How do I get a token?
Create an app in the PayPal Developer Dashboard and exchange the client ID and secret for a token via /v1/oauth2/token; the README has an example.
Is there a remote server?
Yes, PayPal docs list mcp.paypal.com and mcp.sandbox.paypal.com with SSE and HTTP transports and PayPal account sign-in.
Related
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
The official CCXT MCP server and skills: market data, balances and opt-in trading across crypto exchanges and prediction markets
Skill plugins for analyzing stocks, earnings, options and startups, plus readers for social feeds and market data
Skills and an MCP server for options traders: quotes, technical analysis, Greeks, spreads, scanners and Interactive Brokers portfolio