PayPal AI Toolkit plugin
The PayPal plugin for Claude Code, Codex and Cursor: an API best-practices skill, reference commands and a sandbox MCP server
- 48 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The sandbox MCP server creates orders, invoices and refunds with a developer token
- The hook fires on every edit of a file with PayPal code and changes the agent's behavior
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/paypal-ai-toolkitDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The sandbox MCP server creates orders, invoices and refunds with a developer token
- The hook fires on every edit of a file with PayPal code and changes the agent's behavior
This is third-party code. Review the repository files before installing.
What it does
The plugin bundles a skill, five commands, a hook and a connection to PayPal's sandbox MCP server. The `paypal-best-practices` skill activates when the agent notices work on a payment integration: it knows recommended and deprecated APIs, order, subscription and invoice flows, webhook verification, error handling and sandbox testing. The `paypal-routing` skill directs questions to the right command or reference file. Commands for Claude Code and Cursor: `/paypal:doctor` scans code for integration problems, `/paypal:explain-error` explains an error code with causes and fixes, `/paypal:sandbox` and `/paypal:test-accounts` give help on test accounts, cards and scenarios, and `/paypal:setup` configures the plugin and refreshes the token. A `PreToolUse` hook requires the agent to consult the skill and the SDK version (v5 or v6) before editing a file with PayPal code. The sandbox MCP server works over SSE and gives the agent orders, payments and refunds, invoices, subscriptions, disputes, catalog, shipments and reports.
Who it is for. Developers wiring PayPal into a shop or service and writing the integration together with an agent.
Good fit when
- The agent writes a PayPal checkout and has to use current APIs and avoid deprecated ones
- An error code such as `INSTRUMENT_DECLINED` or `422 UNPROCESSABLE_ENTITY` is unclear and you ask for causes and fixes
- Webhooks do not arrive and `/paypal:doctor` scans the project for the cause
- You create a test invoice or order in the sandbox through MCP and check a refund scenario
- One integration is driven from Claude Code, Codex and Cursor in turn
Not a fit when
- You need live money operations: the plugin's MCP server is wired to the sandbox
- The integration uses a different payment provider: the skill and commands know PayPal only
- There is no PayPal Developer account or sandbox token: the MCP server will not activate without them
Example request
/paypal:explain-error INSTRUMENT_DECLINEDLimitations
A PayPal Developer account and a sandbox access token are required, and the token lives up to 8 hours depending on scope. After a 401 error, refresh it with `/paypal:setup refresh`.
The token goes into the agent config: `~/.claude/settings.json`, `~/.codex/config.toml` or the Configure panel in Cursor. An `export` line in `~/.zshrc` does not work for apps launched from a graphical shell.
After installing, quit the agent completely and reopen it.
Slash commands exist in Claude Code and Cursor; in Codex the same capabilities work through a plain request.
How to disable. In Claude Code remove the plugin with `/plugin uninstall paypal`; in Codex and Cursor use the agent's plugin manager. Delete `PAYPAL_SANDBOX_ACCESS_TOKEN` from the config.
FAQ
How do I install the plugin in Claude Code?
Run `/plugin install paypal@claude-plugins-official` and then `/reload-plugins`. The repository is in Anthropic's official marketplace, which Claude Code adds by itself.
How do I install it in Codex and Cursor?
For Codex run `codex plugin marketplace add paypal/AI-Toolkit`, then `codex plugin add paypal@paypal-ai-toolkit`. For Cursor add the repository with `cursor-agent plugin marketplace add https://github.com/paypal/AI-Toolkit` and install `paypal` through `/plugin`.
Does the plugin work with a live account?
No, the plugin's MCP server is connected to the PayPal sandbox. It does not process real payments.
What if MCP answers 401?
The sandbox token expired: it lives up to 8 hours. Run `/paypal:setup refresh`, then restart the agent completely.
How does the plugin differ from paypal-agent-toolkit?
The plugin's core is a skill, commands and a hook for a correct integration, with the sandbox MCP alongside. The paypal-agent-toolkit set is packaged as an MCP server and an SDK.
Discussion
No questions or reviews yet.
Related
PluginsPayPal's official agent toolkit: an MCP server and SDK for invoices, orders, subscriptions, refunds and disputes
Mastercard plugin with a skill and an MCP server: the agent checks the service catalog and integration guides.
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
Official WeChat Pay skill: Claude Code and Cursor choose a product, write payment code, review the integration and troubleshoot errors
A skill that connects an agent to EasyPay: Stripe products and invoices, SBP and T-Bank payout links, crypto and Mercury in natural language
Plugin with a commercial real estate skill library: deal screening, underwriting, due diligence, leasing and investor reporting.
README in short
The description walks through installation for three agents, getting a sandbox token with an OAuth request and storing it in the config. Next come a command table with examples, a list of MCP server capabilities and the plugin layout with separate manifests for Claude Code, Codex and Cursor.