Creativity · MCP — server

MCP PayPal Server

PayPal is one of the most widely used consumer payment rails. The MCP PayPal Server wraps the PayPal REST API to let MCP clients create invoices, search transactions, capture orders, and issue refunds — a handy copilot for finance and support teams.

MCP facts

Kind
server
Ecosystem
anthropic-mcp
Language
TypeScript / Node.js
Transports
stdio

Capabilities

  • Tools: search_transactions, create_invoice, capture_order, refund_payment, list_subscriptions
  • OAuth2 client credentials flow
  • Sandbox and live environment switches

Install

npx -y @modelcontextprotocol-community/server-paypal

Configuration

{
  "mcpServers": {
    "paypal": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol-community/server-paypal"],
      "env": {
        "PAYPAL_CLIENT_ID": "<client-id>",
        "PAYPAL_CLIENT_SECRET": "<client-secret>",
        "PAYPAL_MODE": "live"
      }
    }
  }
}

Frequently asked questions

Is refund_payment really exposed?

Yes in capable servers — but always gate it behind MCP client approval. Refunding from a chat should be a confirmed human action.

Sandbox vs live?

Set PAYPAL_MODE=sandbox during development and swap to live for production. The server routes to the corresponding REST endpoint.

Webhooks?

The MCP server is request-driven; webhooks (payment.completed, dispute.created) should be processed by a separate service that writes to a database the server can query.

Sources

  1. PayPal REST APIs — accessed 2026-04-20
  2. Model Context Protocol — accessed 2026-04-20