PayPal MCP Server

PayPal's official MCP server (hosted at mcp.paypal.com with OAuth, or local via the agent toolkit) brings the operational side of a PayPal business account into conversation: invoicing, payment and refund management, dispute tracking, subscription plans, shipment tracking and transaction reporting.

Invoicing is the flagship flow, and a genuinely good fit for natural language: "invoice Acme Corp $2,400 for March consulting, net-30" carries all the structure an invoice needs, so dictating it beats form-filling. Follow-ups ("send a reminder for every invoice more than two weeks overdue") turn receivables-chasing — the chore every freelancer defers — into a sentence.

The reporting and dispute tools serve the Monday-morning questions: what came in last week, what's pending, which disputes need evidence by when. For small businesses running on PayPal, having these answers conversationally rather than dashboard-deep changes how often they actually get asked.

The trust posture mirrors Stripe's: OAuth on the hosted server, scoped credentials locally, client-side confirmations for anything that moves money or messages customers. Sandbox mode is the right place to learn its behaviour. It's a narrower server than Stripe's (no docs-search half) but for its audience — businesses whose money already flows through PayPal — the invoice-remind-report loop alone justifies the ten-minute setup.

Before you switch to live

• Create both sandbox personas in the developer dashboard, buyer and seller. Watching a test invoice actually arrive tells you more than watching one get created.
• Access tokens from PayPal's OAuth endpoint expire in hours, not months. A local setup without a refresh step turns into a weekly ritual of re-pasting PAYPAL_ACCESS_TOKEN.
• Creating and sending an invoice are deliberately two calls. Create the draft, read it back, then send — a wrong draft costs nothing, a wrong sent invoice costs an apology.
• State the currency explicitly. Invoices follow the account's supported currency list, and anything cross-currency picks up conversion fees the recipient will notice.