Mcp Paypal

io.github.codesparPublished by GitHub account codesparv0.1.2Updated Oct 24, 2026

MCP server for PayPal — global payments + payouts: Orders v2, Payments, Subscriptions, Disputes

The publisher's own server: Paypal

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.codespar/mcp-paypal
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account codespar for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.codespar%2Fmcp-paypal.svg)](https://sourceweft.com/mcp/io.github.codespar%2Fmcp-paypal?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server that lets an assistant create, capture, refund and pay out PayPal payments, manage subscriptions and handle disputes via the PayPal REST API.

What you can do: Create, fetch, authorize and capture PayPal orders, and capture or void authorizations
Refund captured payments and look up payment details
Create and inspect batch payouts and individual payout items
Create, fetch and cancel billing subscriptions
List and fetch disputes, and accept a dispute claim
List app webhooks and verify webhook event signatures
When to use it: Useful for merchants or marketplaces with a PayPal business account that want an assistant to drive checkout, payouts, subscriptions and dispute handling, ideally starting in the sandbox environment.
Requirements: Runs locally as an npm package over stdio (npx @codespar/mcp-paypal); desktop client only. Needs a PayPal REST app client id and secret in PAYPAL_CLIENT_ID and PAYPAL_CLIENT_SECRET, plus PAYPAL_ENV set to sandbox (default) or live. Network access to PayPal's API endpoints.

Before you install

The client secret grants full access to the PayPal app's payments; keep it out of logs and shared configs. Many tools move real money or change state: capturing, refunding, voiding, batch payouts, cancelling subscriptions and accepting dispute claims. Setting PAYPAL_ENV to live points everything at production. Arbitrary REST body fields are forwarded verbatim, so requests are not limited to the declared schemas.

Installation

In SourceWeft

Open Mcp Paypal in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-paypal

MCP server for PayPal — global payments and payouts via the PayPal REST API.

Target customer: LatAm SaaS / marketplaces selling globally that already hold a PayPal merchant account and want agent-driven checkout, payouts, subscriptions, and dispute handling.

Tools (19)

Tool	Purpose
`create_order`	Create a PayPal Order via POST /v2/checkout/orders.
`get_order`	Fetch a PayPal Order by id via GET /v2/checkout/orders/{id}.
`capture_order`	Capture payment for an approved order via POST /v2/checkout/orders/{id}/capture.
`authorize_order`	Authorize payment for an approved order via POST /v2/checkout/orders/{id}/authorize.
`capture_authorization`	Capture a previously authorized payment via POST /v2/payments/authorizations/{id}/capture.
`refund_capture`	Refund a captured payment via POST /v2/payments/captures/{id}/refund.
`void_authorization`	Void (release) an unsettled authorization via POST /v2/payments/authorizations/{id}/void.
`get_payment_details`	Fetch a payment object by id via GET /v2/payments/{type}/{id}.
`create_batch_payout`	Create a batch payout via POST /v1/payments/payouts.
`get_payout`	Fetch a payout batch by id via GET /v1/payments/payouts/{batch_id}.
`get_payout_item`	Fetch a single payout item by id via GET /v1/payments/payouts-item/{item_id}.
`create_subscription`	Create a billing subscription via POST /v1/billing/subscriptions.
`get_subscription`	Fetch a subscription by id via GET /v1/billing/subscriptions/{id}.
`cancel_subscription`	Cancel an active subscription via POST /v1/billing/subscriptions/{id}/cancel.
`list_disputes`	List disputes via GET /v1/customer/disputes.
`get_dispute`	Fetch a dispute by id via GET /v1/customer/disputes/{id}.
`accept_dispute_claim`	Accept liability for a dispute claim via POST /v1/customer/disputes/{id}/accept-claim.
`list_webhooks`	List configured webhooks for the app via GET /v1/notifications/webhooks.
`verify_webhook_signature`	Verify a webhook event signature via POST /v1/notifications/verify-webhook-signature.

Install

Environment

bash

PAYPAL_CLIENT_ID="..."       # REST app client idPAYPAL_CLIENT_SECRET="..."   # REST app client secret (OAuth2)PAYPAL_ENV="sandbox"         # 'sandbox' (default) or 'live'

PAYPAL_CLIENT_ID="..."       # REST app client idPAYPAL_CLIENT_SECRET="..."   # REST app client secret (OAuth2)PAYPAL_ENV="sandbox"         # 'sandbox' (default) or 'live'

Endpoints:

sandbox -> https://api-m.sandbox.paypal.com
live -> https://api-m.paypal.com

Authentication

PayPal REST APIs use OAuth2 client_credentials. The server posts CLIENT_ID:CLIENT_SECRET (Basic auth) to /v1/oauth2/token with grant_type=client_credentials and caches the bearer token until 60s before expiry, refreshing on demand.

Run

bash

# stdio (default — for Claude Desktop, Cursor, etc)npx @codespar/mcp-paypal
# HTTP (for server-to-server testing)MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-paypal

# stdio (default — for Claude Desktop, Cursor, etc)npx @codespar/mcp-paypal
# HTTP (for server-to-server testing)MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-paypal

Notes

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.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/payments/paypal/README.md at commit d0a519a

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Other Paypal integrations

Paypal

com.paypal.mcpOfficial publisher

A remote PayPal MCP server that gives an AI assistant access to PayPal services and operations.

Streamable HTTPWeb executableAuth

Business & CommerceCredential requiredOct 24, 2026

PayPal, guarded

Published by GitHub account Fizzl13

PayPal Agent Toolkit MCP server that lets an assistant read and act on a PayPal business account, with a guard that limits refunds and asks the owner to…

STDIODesktop only

Finance49 toolsOct 30, 2026

Paypal Mcp

Published by GitHub account mrfentmen

Query PayPal sandbox: orders, captures, billing plans. Sandbox only.

STDIODesktop only

Not validated yetOct 24, 2026

Paypal

Published by GitHub account pipeworx-io

Read-only PayPal access through the Pipeworx gateway: lets an assistant list transactions, orders, invoices and disputes, plus route other data questions.

Streamable HTTPWeb executable

Finance49 toolsNov 4, 2026

Paypal Mcp Server

Published by GitHub account paypal

Local PayPal MCP server that lets an assistant create and manage invoices, orders, payments, refunds, disputes, subscriptions and products via PayPal APIs.

STDIODesktop only

FinanceNot validated yetOct 24, 2026