PayPal

What your agent can do

PayPal gives your agent 19 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →create_order — Create a PayPal Order via POST /v2/checkout/orders. Pass intent ('CAPTURE' or 'AUTHORIZE') and purchase_units (each with an amount object). Returns the order with id, status, and HATEOAS links (including the approve URL for the buyer).
• →get_order — Fetch a PayPal Order by id via GET /v2/checkout/orders/{id}. Returns the full order including status, purchase_units, and payments collection.
• →capture_order — Capture payment for an approved order via POST /v2/checkout/orders/{id}/capture. Use after the buyer approves an order with intent=CAPTURE. Returns the captured payment details.

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_order", { /* ... */ });

Install

$ npm install @codespar/mcp-paypal

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "paypal": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-paypal"
      ],
      "env": {
        "PAYPAL_CLIENT_ID": "<your_paypal_client_id>",
        "PAYPAL_CLIENT_SECRET": "<your_paypal_client_secret>"
      }
    }
  }
}

After restart, your agent can call any of the 19 tools below — try create_order first.

Environment variables · 3

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 19

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions