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.