Mcp Paypal

io.github.codespar由 GitHub 账号 codespar 发布v0.1.2更新于 Oct 24, 2026

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

发布方自己的服务：Paypal

已验证STDIO仅桌面金融商业与电商

服务详情

标识符: io.github.codespar/mcp-paypal
传输: STDIO
运行时: Desktop only
信任: Verified
发布于: Sep 16, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 codespar。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![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)

概览

AI 生成的概览

本地 MCP 服务器，让助手通过 PayPal REST API 创建、捕获、退款和批量付款，并管理订阅与争议。

可以做什么: 创建、查询、授权并捕获 PayPal 订单，以及捕获或作废授权
对已捕获付款发起退款，并查询付款详情
创建和查询批量付款批次及单笔付款项
创建、查询和取消计费订阅
列出并查询争议，接受争议索赔
列出应用 Webhook 并校验 Webhook 事件签名
适用场景: 适合已拥有 PayPal 商家账户的商户或市场平台，希望由助手处理结账、付款、订阅和争议；建议先在 sandbox 环境试用。
运行要求: 以 npm 包形式在本地通过 stdio 运行（npx @codespar/mcp-paypal），仅支持桌面客户端。需要 PayPal REST 应用的 client id 与 secret，分别放在 PAYPAL_CLIENT_ID 和 PAYPAL_CLIENT_SECRET，并用 PAYPAL_ENV 指定 sandbox（默认）或 live。需要访问 PayPal API 的网络连接。

安装前请注意

client secret 拥有该 PayPal 应用的完整支付权限，切勿写入日志或共享配置。多个工具会真实动账或改变状态：捕获、退款、作废授权、批量付款、取消订阅、接受争议索赔。将 PAYPAL_ENV 设为 live 会直接指向生产环境。服务器会原样转发任意 REST 请求体字段，请求不受已声明 schema 限制。

安装

在 SourceWeft 中

打开控制台中的 Mcp Paypal，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

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.