Happy slice of mcp pizzaMCP.pizza

agent-toolkit

MCP.Pizza Chef: paypal

PayPal's own toolkit powers a connector that hands your assistant 36 tools over your merchant account: draft and send invoices, chase reminders, list transactions, look up an order, issue a refund, cancel a subscription, and review or accept a dispute. These are real actions on a real account, not previews. It starts in PayPal's test mode, so nothing touches actual money until you switch it over. You supply a sign-in token that PayPal only issues for a few hours at a time.

Data
Other

Use This MCP server To

Draft and send an invoice without opening PayPal Ask which invoices are still unpaid this month Send a polite reminder on an overdue invoice Refund a customer who asked for their money back Check what a disputed payment was actually for Set up a repeating invoice for a monthly client

README

PayPal Agent Toolkit

The PayPal Agent Toolkit enables popular agent frameworks including OpenAI's Agent SDK, LangChain, Vercel's AI SDK, and Model Context Protocol (MCP) to integrate with PayPal APIs through function calling. It includes support for TypeScript and is built on top of PayPal APIs and the PayPal SDKs.

Available tools

The PayPal Agent toolkit provides the following tools:

Invoices

  • create_invoice: Create a new invoice in the PayPal system, including recipient billing details, line items, an invoice note, a custom color theme, an optional shipping cost, and an option to enable PAY_BY_BANK as a payment method
  • create_recurring_series: Create a recurring invoice series that automatically generates and sends invoices on a schedule
  • list_invoices: List invoices with optional pagination and filtering
  • get_invoice: Retrieve details of a specific invoice
  • send_invoice: Send an invoice to recipients
  • send_invoice_reminder: Send a reminder for an existing invoice
  • cancel_sent_invoice: Cancel a sent invoice
  • generate_invoice_qr_code: Generate a QR code for an invoice

Payments

  • create_order: Create an order in PayPal system based on provided details
  • get_order: Retrieve the details of an order
  • pay_order: Process payment for an authorized order
  • create_refund: Process a refund for a captured payment.
  • get_refund: Get the details for a specific refund.

Dispute Management

  • list_disputes: Retrieve a summary of all open disputes
  • get_dispute: Retrieve detailed information of a specific dispute
  • accept_dispute_claim: Accept a dispute claim

Shipment Tracking

  • create_shipment_tracking: Create a shipment tracking record
  • get_shipment_tracking: Retrieve shipment tracking information
  • update_shipment_tracking: Update shipment tracking information

Catalog Management

  • create_product: Create a new product in the PayPal catalog
  • list_products: List products with optional pagination and filtering
  • show_product_details: Retrieve details of a specific product

Subscription Management

  • create_subscription_plan: Create a new subscription plan
  • list_subscription_plans: List subscription plans
  • show_subscription_plan_details: Retrieve details of a specific subscription plan
  • create_subscription: Create a new subscription
  • show_subscription_details: Retrieve details of a specific subscription
  • update_subscription: update an existing subscription
  • cancel_subscription: Cancel an active subscription

Reporting and Insights

  • list_transactions: List transactions with optional pagination and filtering
  • get_merchant_insights: Retrieve business intelligence metrics and analytics for a merchant

TypeScript

Installation

You don't need this source code unless you want to modify the package. If you just want to use the package run:

npm install @paypal/agent-toolkit

agent-toolkit FAQ

Do I need an API key?
Yes, of a sort. You need a PayPal Business account, a developer app registered against it, and then a short-lived sign-in token generated from that app's id and secret.
Will it move real money?
Not at first. It starts in PayPal's test mode by default and only touches your live account if you deliberately set it to production. Once live, refunds and dispute decisions are real.
Why does it stop working after a few hours?
Because the token you pasted in expires. PayPal issues these for a limited window and this connector never renews one, so you have to generate a fresh token and paste it again.
How many tools does it add?
36 in the current code, a handful more than the readme lists, covering invoices, orders, refunds, products, subscriptions, shipping, disputes and transaction reports.
Can I use this to chase unpaid invoices?
Yes. Ask which ones are overdue, then have it send reminders one at a time or work through the whole list.
Which apps does it work in?
Claude Desktop, Cursor, Cline and GitHub Copilot are named in the instructions, and any other app that accepts a launch command will work too.
Is it safe to let an assistant settle a dispute?
Be careful. Accepting a dispute claim refunds the buyer and closes the case in their favour with no undo. Rehearse in test mode before pointing it at your live account.
How hard is setup?
Harder than pasting a snippet. You need Node installed, and you must generate the sign-in token yourself from PayPal's developer dashboard before the configuration will work.