MCP field guide / PayPal

// mcp field guide · fintech

PayPal MCP server

Like Stripe, this is a payments surface — an agent can capture a payment, issue a refund, or cancel a subscription on a live account. And like all money movement, it doesn't rewind: a captured payment can't be un-captured, and a refund is a new transaction, not an undo. Here's the sourced read for fintech.

Maintainer: PayPal (official) Package: @paypal/mcp · mcp.paypal.com License: Apache-2.0

GUARD FIT · READ SURFACE

PASS-THROUGH

Read invoices, orders, refunds, disputes, transactions, insights. Low-risk — a guard should not add friction here.

GUARD FIT · MONEY MOVEMENT

STRONG

Capture (pay_order), create_refund, cancel subscription/invoice, accept a dispute — real money, effectively irreversible.

Overall fit: STRONG — for a payments surface, unambiguously so.

What it is

PayPal's official MCP server (the MCP surface of the PayPal Agent Toolkit) runs local (@paypal/mcp, Apache-2.0, via npx) or as a PayPal-hosted remote at mcp.paypal.com (sandbox at mcp.sandbox.paypal.com), over SSE and Streamable HTTP with OAuth 2.1 — where the token's scopes gate which tools are even visible. It exposes PayPal's commerce APIs — invoicing, orders/payments, refunds, disputes, catalog, subscriptions, shipment tracking and reporting — as tools an agent can call.12

Tools by risk surface

TierTools
read-onlyget_invoice/list_invoices, get_order, get_refund, list_disputes/get_dispute, list_products, show_subscription_details, list_transactions, get_shipment_tracking
mutatingcreate_invoice, send_invoice, send_invoice_reminder, create_order (money not yet captured), create_product, create_subscription_plan/create_subscription, create_shipment_tracking
money movespay_order (captures payment), create_refund, cancel_sent_invoice, cancel_subscription, accept_dispute_claim (commits funds); remote Commerce checkout_cart

One thing we did not assert (because the catalog doesn't): there is no payout / "send money" / batch-disbursement tool in the current official catalog. The toolkit is merchant-inbound — get paid, refund, bill — not outbound disbursement. If a payout tool is claimed elsewhere, treat it as unverified. (A few remote-only Commerce tools and reporting tools appear in the docs catalog but weren't confirmed in the repo — noted as such.)

Real use cases

AI billing assistant. Create and send invoices in bulk from natural language, send reminders, generate QR codes; read list_invoices to report status.

Order-to-cash / support. Capture an authorized order (pay_order), then handle post-sale exceptions by reading disputes and issuing refunds (create_refund).

Subscription ops. Create/update plans and subscriptions, cancel churned accounts, with list_transactions for reporting.

Where a human-approval guard fits

For a payments surface this is unambiguously strong, and honestly so:

The honest core: ChronoMCP can classify these tools as financial, show an impact diff, require approval, and log a hash-chained trail — but its "compensation" for a capture would itself be a new refund transaction, and money once disbursed can't be un-sent. Compensation is not undo — for money, the only real control is the one that acts before it moves. The read surface (get_*/list_*) is low-risk and should pass through.

Put a human before the capture

Gate pay_order, create_refund and cancels on a human; keep a tamper-evident record of every approval. Reads pass straight through.

Read the quickstart → More MCP profiles

Sources

  1. PayPal — official repo: github.com/paypal/paypal-mcp-server · MCP quickstart: developer.paypal.com/ai-tools/mcp-server
  2. PayPal — full tool catalog: developer.paypal.com/ai-tools/agent-tools
  3. Remote MCP tool-expansion announcement (refund/subscription tools): developer.paypal.com/community/blog/mcp-server-toolexpansion

Profiles describe third-party software from its public sources; ChronoMCP is not affiliated with PayPal. A few remote-only/reporting tool names appear in the docs but weren't confirmed in the repo; capture/refund reversibility and fee behavior are governed by PayPal's payment APIs. Risk groupings are our classification. Sources current as of Aug 2026 — check the source links. Nothing here is financial or compliance advice.