---
title: "PayPal MCP Server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/paypal/
description: "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."
---

# PayPal MCP Server: review, setup & limitations · Undominated.ai

> 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.

[← Explore all mcp servers](/mcp-servers/)

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.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/paypal/paypal-mcp-server)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 4 linked sources
 Publisher PayPal
 Licence [Apache-2.0 ↗](https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/LICENSE)
 Revision 6b1ced271959
 [Read what was—and wasn’t—checked ↓](#review)

“The PayPal Model Context Protocol server allows you to integrate with PayPal APIs through function calling.”

 [PayPal · upstream description ↗](https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/README.md) Our analysis follows below.

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.

### A good fit for

 - Looking up PayPal transactions, orders or invoices during support or reconciliation.
- Drafting sandbox payment flows before touching live commerce operations.

### Weigh up before choosing

 - Payment tools can move real money when pointed at production: the README lists pay_order, create_refund and cancel_subscription. Keep the sandbox environment until live use is explicitly approved.
- Needs a PayPal access token; the token's permissions bound everything the assistant can do. The README says sandbox tokens last 3-8 hours and production tokens 8 hours.
- The README's one-line command puts PAYPAL_ACCESS_TOKEN="..." after the package name. index.ts parses only arguments that start with --, so the token must come from --access-token or the PAYPAL_ACCESS_TOKEN environment variable.
- package.json depends on @paypal/agent-toolkit at "latest", so the tool implementations are not pinned by this revision.

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.

[Upstream setup instructions ↗](https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/README.md)

DOCUMENTED COMMAND

 npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX" Copy command ↗

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"
 }
 }
 }
} Copy configuration ↗

### Compatibility

MCP clients that launch a stdio process with Node.js 18 or later and npx; the README names Claude Desktop, Cline, Cursor and GitHub Copilot as hosts. · A PayPal developer app with sandbox or production credentials.

### Implementation

TypeScript

### Transports

stdio

### PayPal access token

 - Authenticates with one OAuth access token from PAYPAL_ACCESS_TOKEN or --access-token; the README shows generating it with the app's client ID and secret.
- Reads invoices, orders, refunds, disputes, shipment tracking, products, plans, subscriptions and transactions visible to the token.
- Enabled tools can create and send invoices, create and pay orders, issue refunds, accept dispute claims, and create, update or cancel products, plans and subscriptions.

### Cost model

Apache-2.0 server source. PayPal transaction and service fees are separate; none was reviewed.

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 ↗](https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/README.md) Checked 2026-10-13 https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/README.md Supports: upstreamDescription, summary, install, configExample, compatibility, tools, limitations, access
- [Server entry point ↗](https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/src/index.ts) Checked 2026-10-13 https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/src/index.ts Supports: transports, accepted tools, sandbox default, whySelected, limitations
- [Package manifest ↗](https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/package.json) Checked 2026-10-13 https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/package.json Supports: language, package name, Node version, dependencies
- [Repository licence ↗](https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/LICENSE) Checked 2026-10-13 https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/LICENSE Supports: license

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Adyen MCP Server ↗ Calls Adyen Checkout and Management APIs from an MCP client: payment sessions and links, cancels and refunds, terminals, webhooks, users and API credentials, with a flag to load only chosen tools.](/mcp-servers/adyen/)[### Razorpay MCP Server ↗ Inspect Razorpay payments and settlements and optionally perform payment, refund and other merchant operations.](/mcp-servers/razorpay/)[### Square MCP Server ↗ Gives an MCP client generic access to Square's API: discover a service's methods and types, then execute requests, locally with an access token or through Square's hosted OAuth endpoint.](/mcp-servers/square/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
