← Explore all 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.

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

Upstream setup instructions ↗

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.

  1. 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.
  2. Narrow --tools to the product.action names the deployment needs instead of all before going live.
  3. 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.

  1. https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/README.md

    Supports: upstreamDescription, summary, install, configExample, compatibility, tools, limitations, access

  2. Server entry point ↗Checked

    https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/src/index.ts

    Supports: transports, accepted tools, sandbox default, whySelected, limitations

  3. Package manifest ↗Checked

    https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/package.json

    Supports: language, package name, Node version, dependencies

  4. Repository licence ↗Checked

    https://github.com/paypal/paypal-mcp-server/blob/6b1ced271959d5ea53857502dc6e5ddef0cbc126/LICENSE

    Supports: license

Evidence & Ask