PAYMENTS / PayPal
PayPal MCP Server
Local stdio server that gives an assistant PayPal invoice, order, refund, dispute, shipment, catalog, subscription and transaction tools. The required --tools argument selects which tools load, and the environment defaults to sandbox.
“The PayPal Model Context Protocol server allows you to integrate with PayPal APIs through function calling.”
01 / THE REASONING
Why this made the selection.
- src/index.ts refuses to start without --tools and accepts only the 28 product.action names it lists (or all), so a deployment can load exactly the PayPal operations it needs.
- The environment defaults to sandbox: index.ts treats anything other than PAYPAL_ENVIRONMENT or --paypal-environment set to production as sandbox.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- README.md at 6b1ced271959d5ea53857502dc6e5ddef0cbc126: npx command, Claude Desktop configuration, tool list, environment variables, access-token generation.
- src/index.ts at the same commit: argument parsing, accepted tools, sandbox default, stdio transport.
- package.json at the same commit: @paypal/mcp 1.8.1, Node 18 or later, tsc build, @paypal/agent-toolkit at latest.
- LICENSE at the same commit: Apache-2.0 terms.
Our findings
- Tool exposure is controlled by the required --tools argument; the README example enables the full set with --tools=all.
- Environment selection between sandbox and production is configuration, not a code change.
- The README lists 30 tools across invoices, payments, disputes, shipment tracking, catalog, subscriptions and transactions; index.ts's ACCEPTED_TOOLS has 28 product.action names.
- index.ts connects only a StdioServerTransport. The SSE and Streamable HTTP transports previously recorded do not appear in the README or in src/index.ts and were removed.
- The previous upstreamDescription did not appear in the README; it is replaced by the README's first sentence. install.command is the README's npx line verbatim; configExample matches the README's Claude Desktop block.
- Health on 2026-10-13: repository not archived, default-branch HEAD was this commit (last push 2025-10-28), GitHub reports Apache-2.0, package.json names @paypal/mcp.
Not established by this review
- Server startup, authentication and payment execution were not tested.
- @paypal/agent-toolkit, which implements the tools, was not read.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
DOCUMENTED COMMAND
npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX" Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- Export PAYPAL_ACCESS_TOKEN (and PAYPAL_ENVIRONMENT=SANDBOX) in the environment, or pass --access-token=...; index.ts ignores the NAME=value words in the README line.
- Narrow --tools to the product.action names the deployment needs instead of all before going live.
- For a client, use the README's Claude Desktop block, which sets both variables in env.
Before you start
- Node.js 18 or later with npx.
- A PayPal developer app and an access token generated from its client ID and secret.
Documented configuration example
Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.
{
"mcpServers": {
"paypal": {
"command": "npx",
"args": [
"-y",
"@paypal/mcp",
"--tools=all"
],
"env": {
"PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN",
"PAYPAL_ENVIRONMENT": "SANDBOX"
}
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- PayPal MCP server readme ↗Checked
https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/README.md
Supports: upstreamDescription, summary, install, configExample, compatibility, tools, limitations, access
- Server entry point ↗Checked
https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/src/index.ts
Supports: transports, accepted tools, sandbox default, whySelected, limitations
- Package manifest ↗Checked
https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/package.json
Supports: language, package name, Node version, dependencies
- Repository licence ↗Checked
https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/LICENSE
Supports: license