# PayPal MCP

> Lets your agent create and send PayPal invoices, take orders and issue refunds, manage subscriptions and disputes, and pull sales insights.

PayPal's own hosted MCP server for merchants. Sign in with your PayPal account and your agent can run everyday PayPal jobs in plain words: invoices, orders and refunds, products and subscriptions, disputes, shipment tracking and sales reporting.

What you can do with it
- Create and send invoices, send reminders, cancel a sent invoice and make a QR code for paying in person
- Create orders, capture their payment, and refund a captured payment in full or in part
- Add products to your PayPal catalog and look them up
- Create subscription plans and subscriptions, and show, update or cancel them
- List disputes, read their details and accept a claim
- Add, check and update shipment tracking for a transaction
- List recent transactions and get sales and order insights over a date range

How it connects
PayPal hosts it at https://mcp.paypal.com/mcp for your live account and at https://mcp.sandbox.paypal.com/mcp for testing in PayPal's sandbox; both also offer an /sse endpoint. The first time you connect, your agent sends you to PayPal to log in and authorize it. Instead, you can send an access token made from your app's client ID and secret in the PayPal Developer Dashboard. PayPal's examples use Claude, and any MCP client works.

Good to know
- Build and test against the sandbox address. The live address acts on your real account: invoices go out, payments are captured and refunds are issued.
- PayPal also publishes the same tools as a local server (npx @paypal/mcp) that runs with an access token and a SANDBOX or PRODUCTION setting.
- With an extra header, the hosted server adds commerce tools for finding and buying gift cards; PayPal limits these to gift cards for now.
- Keep card numbers, passwords and other secrets out of your prompts; PayPal's toolkit rejects them.

- Type: Plugin
- Made by: Paypal
- Category: Finance
- Formats: Remote MCP
- Version: 1.0.0
- Website: https://developer.paypal.com/ai-tools/mcp-server
- Page: https://pluginboard.ai/plugins/paypal-mcp

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `Authorization` (required): OAuth Bearer token for API authentication (format: Bearer <token>)

Replace each `<NAME>` placeholder with your own value.

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://mcp.paypal.com/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://mcp.paypal.com/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://mcp.paypal.com/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://mcp.paypal.com/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://mcp.paypal.com/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22paypal-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.paypal.com%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http --header 'Authorization: <Authorization>' paypal-mcp https://mcp.paypal.com/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=paypal-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5wYXlwYWwuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IjxBdXRob3JpemF0aW9uPiJ9fQ%3D%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "paypal-mcp": {
      "url": "https://mcp.paypal.com/mcp",
      "headers": {
        "Authorization": "<Authorization>"
      }
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http --header 'Authorization: <Authorization>' paypal-mcp https://mcp.paypal.com/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add paypal-mcp --url https://mcp.paypal.com/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "paypal-mcp": {
      "url": "https://mcp.paypal.com/mcp",
      "headers": {
        "Authorization": "<Authorization>"
      }
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http --header 'Authorization: <Authorization>' paypal-mcp https://mcp.paypal.com/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://mcp.paypal.com/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add paypal-mcp --url https://mcp.paypal.com/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://mcp.paypal.com/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login paypal-mcp.

### OpenCode

Run in your terminal:

```shell
opencode mcp add paypal-mcp --url https://mcp.paypal.com/mcp
```

If it needs a key: For https://mcp.paypal.com/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add paypal-mcp --url https://mcp.paypal.com/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "paypal-mcp": {
      "url": "https://mcp.paypal.com/mcp",
      "headers": {
        "Authorization": "<Authorization>"
      }
    }
  }
}
```

If it signs in with OAuth: If https://mcp.paypal.com/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).