PayPal Agent Toolkit MCP
PayPal's official agent toolkit: an MCP server and SDK for invoices, orders, subscriptions, refunds and disputes
- 197 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- Processes order payments and refunds
- Sends invoices to customers and changes subscriptions
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/paypal-agent-toolkitDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Processes order payments and refunds
- Sends invoices to customers and changes subscriptions
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 onesMCP
- Transport
- stdio, sse, http
- Authentication
- OAuth
Environment variables
PAYPAL_ACCESS_TOKENrequired, secret- PayPal access token for the local server
PAYPAL_ENVIRONMENT- SANDBOX or PRODUCTION, default SANDBOX
Limitations
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.
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.
Discussion
No questions or reviews yet.
Related
MCP serversStripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
Official Paddle Billing MCP server: catalog, customers, transactions, subscriptions and reports via your agent, with a filter for risky operations
Intuit's official local MCP server: an agent finds and creates invoices, payments and customers in QuickBooks Online
A CLI with an MCP server and a skill: the agent calls paid APIs while the user approves each HTTP 402 stablecoin payment with Touch ID
A skill that connects an agent to EasyPay: Stripe products and invoices, SBP and T-Bank payout links, crypto and Mercury in natural language
MCP server for the MoySklad JSON API 1.2: stock, orders, profit reports and document creation behind two safety gates
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.