Paypal MCP server

Connect Paypal to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Paypal MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the add tracking tool in Paypal
  • Use the manage product tool in Paypal
  • Use the send payout tool in Paypal
  • Use the get order tool in Paypal
  • Use the capture order tool in Paypal
  • Use the manage payment tool in Paypal

Supported Tools

add_tracking

Add Tracking

Add shipment tracking information to a captured PayPal payment. Associates a carrier and tracking number with a transaction so buyers can track their shipments.

manage_product

Manage Product

Create, retrieve, or list PayPal catalog products. Products are used as the basis for billing plans and subscriptions.

send_payout

Send Payout

Send batch payouts to one or more recipients via PayPal email, phone, or PayPal ID. Supports multiple currencies and per-item notes. Returns a batch ID to track the payout status.

get_order

Get Order

Retrieve details of a PayPal order by its ID. Returns the full order object including status, purchase units, payer information, and payment details.

capture_order

Capture Order

Capture payment for an approved PayPal order. The order must have been approved by the buyer first. For orders with intent "AUTHORIZE", use this to finalize the payment after authorization.

manage_payment

Manage Payment

Manage payment authorizations, captures, and refunds. Capture an authorization, void an authorization, refund a captured payment, or view details of authorizations/captures/refunds.

get_payout

Get Payout

Retrieve the status and details of a PayPal batch payout or individual payout item. Track whether payouts have been claimed by recipients.

create_subscription

Create Subscription

Create a new PayPal subscription for a billing plan. Returns an approval URL for the subscriber to activate. The billing plan must already exist.

create_invoice

Create Invoice

Create and optionally send a PayPal invoice. Define line items, recipient email, and invoice details. The invoice is created as a draft and can be automatically sent.

manage_invoice

Manage Invoice

Manage existing PayPal invoices. Send, cancel, or record payment against a draft or sent invoice. Can also retrieve invoice details.

create_order

Create Order

Create a new PayPal checkout order. Supports both immediate capture and authorization-then-capture flows. Can include one or more purchase units, each with its own amount, items, and shipping details. Returns an approval URL for the buyer to complete payment.

manage_subscription

Manage Subscription

Manage an existing PayPal subscription. Retrieve details, suspend, cancel, reactivate, or list transactions for a subscription.

search_transactions

Search Transactions

Search PayPal transaction history by date range, status, amount, and other filters. Useful for reconciliation, reporting, and finding specific transactions.

list_invoices

List Invoices

List PayPal invoices with optional pagination. Returns invoice summaries including status, amounts, and recipient information.

manage_billing_plan

Manage Billing Plan

Create, retrieve, list, activate, or deactivate PayPal billing plans. Billing plans define pricing and billing cycle details for subscriptions.

manage_dispute

Manage Dispute

Manage PayPal customer disputes (chargebacks, claims, inquiries). List disputes, get details, accept claims, provide evidence, or escalate to PayPal.

Connect Paypal to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Paypal in Metorial. In your Metorial portal, enable the Paypal MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Paypal tools.

Run Paypal through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Paypal and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Paypal tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Paypal

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Stripe

Process payments, manage subscriptions, and handle invoices. Create and manage customers, payment methods, and product catalogs. Issue refunds, handle disputes, and submit chargeback evidence. Create checkout sessions and payment links. Manage connected accounts and platform fund flows via Stripe Connect. Configure payouts to bank accounts and debit cards. Apply coupons and promotion codes to subscriptions and invoices. Calculate and collect taxes automatically. Access balance information and transaction history. Upload files for dispute evidence and identity verification. Create and manage virtual and physical payment cards via Issuing. Receive real-time webhook notifications for payment, subscription, invoice, and account events.

Technical notes for Paypal

Process payments, manage orders, and handle financial transactions through PayPal. Create and capture checkout orders with immediate or deferred payment flows. Issue full or partial refunds and void authorizations. Create and manage recurring subscriptions with billing plans, pricing tiers, and trial periods. Send and track invoices, record payments and refunds against them. Send batch payouts to multiple recipients via email, phone, or PayPal ID. View and resolve customer disputes by providing evidence or accepting claims. Save payment methods to a vault for returning customers. Search transaction history for reconciliation and reporting. Add shipment tracking to captured payments. Manage catalog products, onboard merchants via partner referrals, and look up currency exchange rates. Receive webhook notifications for payment, order, subscription, payout, invoice, dispute, and merchant onboarding events.

Frequently asked questions

Common questions about connecting Paypal to AI agents with Metorial.

  1. How many tools does the Paypal MCP server have?
    The Paypal MCP server exposes 16 tools, including Add Tracking, Manage Product, Send Payout. Each one is governed and traced through Metorial.
  2. Paypal exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Paypal MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Paypal and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Paypal MCP server yourself or use the hosted gateway.

Connect Paypal to production AI agents

See how Metorial gives your team governed access to Paypal, with tracing and security controls built in.