MCP field guide / PayPal
// mcp field guide · fintech
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.
GUARD FIT · READ SURFACE
PASS-THROUGHRead invoices, orders, refunds, disputes, transactions, insights. Low-risk — a guard should not add friction here.
GUARD FIT · MONEY MOVEMENT
STRONGCapture (pay_order), create_refund, cancel subscription/invoice, accept a dispute — real money, effectively irreversible.
Overall fit: STRONG — for a payments surface, unambiguously so.
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
| Tier | Tools |
|---|---|
| read-only | get_invoice/list_invoices, get_order, get_refund, list_disputes/get_dispute, list_products, show_subscription_details, list_transactions, get_shipment_tracking |
| mutating | create_invoice, send_invoice, send_invoice_reminder, create_order (money not yet captured), create_product, create_subscription_plan/create_subscription, create_shipment_tracking |
| money moves | pay_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.)
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.
For a payments surface this is unambiguously strong, and honestly so:
pay_order (capture), create_refund, checkout_cart, cancel_subscription, cancel_sent_invoice, and accept_dispute_claim all move or commit real money on a live account.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.
Gate pay_order, create_refund and cancels on a human; keep a tamper-evident record of every approval. Reads pass straight through.
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.