Paypal MCP Server (codespar) - install & status [2026]

01 · Install Paypal

before you install - you'll need

Set PAYPAL_CLIENT_ID, PAYPAL_CLIENT_SECRET, MCP_HTTP before connecting. PAYPAL_ENV is optional or environment-specific per the README.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-payments -- npx -y @codespar/mcp-paypal

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-paypal"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-paypal - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Paypal can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a PayPal Order via POST /v2/checkout/orders, fetch a PayPal Order by id via GET /v2/checkout/orders/{id}, capture payment for an approved order via POST /v2/checkout/orders/{id}/capture, and capture a previously authorized payment via POST /v2/payments/authorizations/{id}/capture.

Capability map

Tools grouped from the project's README - what Paypal lets an agent do.

Order

4 tools - e.g. Create a PayPal Order via POST /v2/checkout/orders.; Fetch a PayPal Order by id via GET /v2/checkout/orders/{id}.; Capture payment for an approved order via POST /v2/checkout/orders/{id}/capture.

create_order · get_order · capture_order · authorize_order

read & search

4 tools - e.g. Fetch a payment object by id via GET /v2/payments/{type}/{id}.; List disputes via GET /v1/customer/disputes.; Fetch a dispute by id via GET /v1/customer/disputes/{id}.

get_payment_details · list_disputes · get_dispute · list_webhooks

Payout

3 tools - e.g. Create a batch payout via POST /v1/payments/payouts.; Fetch a payout batch by id via GET /v1/payments/payouts/{batch_id}.; Fetch a single payout item by id via GET /v1/payments/payouts-item/{item_id}.

create_batch_payout · get_payout · get_payout_item

Subscription

3 tools - e.g. Create a billing subscription via POST /v1/billing/subscriptions.; Fetch a subscription by id via GET /v1/billing/subscriptions/{id}.; Cancel an active subscription via POST…

create_subscription · get_subscription · cancel_subscription

Capture

2 tools - e.g. Capture a previously authorized payment via POST /v2/payments/authorizations/{id}/capture.; Refund a captured payment via POST /v2/payments/captures/{id}/refund.

capture_authorization · refund_capture

auth & access

1 tool - e.g. Void (release) an unsettled authorization via POST /v2/payments/authorizations/{id}/void.

void_authorization

Accept

1 tool - e.g. Accept liability for a dispute claim via POST /v1/customer/disputes/{id}/accept-claim.

accept_dispute_claim

Verify

1 tool - e.g. Verify a webhook event signature via POST /v1/notifications/verify-webhook-signature.

verify_webhook_signature

Limitations (from the README)

- Amounts are objects in PayPal REST: { "currency_code": "USD", "value": "10.50" }. Values are decimal strings. - The server forwards arbitrary REST body fields verbatim under body for tools that accept them, so any field documented in the PayPal REST reference can be passed even if it's not in the MCP inputSchema. - For payment captures / refunds the PayPal-Request-Id header (idempotency) is forwarded when supplied.

04 · Who maintains Paypal

mcp-paypal is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: finance - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-paypal (active, first published 2026-06-20 · 2 versions)
packages: npm:@codespar/mcp-paypal

06 · Paypal FAQ

Is Paypal still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Paypal do?

With this server connected, an agent can create a PayPal Order via POST /v2/checkout/orders, fetch a PayPal Order by id via GET /v2/checkout/orders/{id}, capture payment for an approved order via POST /v2/checkout/orders/{id}/capture, and capture a previously authorized payment via POST /v2/payments/authorizations/{id}/capture.

How do I install Paypal?

Run `npx -y @codespar/mcp-paypal`. The README documents 4 environment variables (PAYPAL_CLIENT_ID, PAYPAL_CLIENT_SECRET, PAYPAL_ENV…) to set first. Set PAYPAL_CLIENT_ID, PAYPAL_CLIENT_SECRET, MCP_HTTP before connecting. PAYPAL_ENV is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Paypal run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Paypal

Alternatives to Paypal

Maintained finance servers if Paypal isn't the fit.

Pairs well with

Servers that cover what Paypal doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Rinne · Stone · Stripe · Stripe Acp · Vindi

More JavaScript MCP servers · Picpay · Pix Bcb · Rapyd · Rede · see all