PayPal Agent Toolkit MCP Server
PayPal API operations including invoices, payments, and disputes via function calling.
Data last scanned today · Reviewed yesterday
Overview
The PayPal Agent Toolkit provides a structured interface for AI agents to interact with PayPal merchant services. It covers a comprehensive suite of operations, ranging from invoice generation and dispute resolution to shipment tracking and subscription management.
Our verdict
This project holds a high-risk security score of 24/100, primarily because it lacks any internal authentication method, meaning any configuration access grants full control over the account. It is not maintained by the official vendor and lacks OAuth support, making it unsuitable for environments requiring strict security boundaries or enterprise-grade access controls.
- Comprehensive coverage of PayPal invoice and payment APIs
- Zero direct dependencies minimize supply-chain attack surfaces
- Compatible with major frameworks like LangChain and Vercel AI SDK
- Lacks any authentication method for protecting tool execution
- Community-maintained rather than official PayPal software
- No read-only mode restricts the ability to limit write actions
Tools
| Tool | Description | Risk |
|---|---|---|
| create_invoice | Create a new invoice in the PayPal system | medium |
| list_invoices | List invoices with optional pagination and filtering | low |
| get_invoice | Retrieve details of a specific invoice | low |
| send_invoice | Send an invoice to recipients | medium |
| send_invoice_reminder | Send a reminder for an existing invoice | medium |
| cancel_sent_invoice | Cancel a sent invoice | medium |
| generate_invoice_qr_code | Generate a QR code for an invoice | low |
| create_order | Create an order in PayPal system based on provided details | medium |
| get_order | Retrieve the details of an order | low |
| pay_order | Process payment for an authorized order | high |
| create_refund | Process a refund for a captured payment. | high |
| get_refund | Get the details for a specific refund. | low |
| list_disputes | Retrieve a summary of all open disputes | low |
| get_dispute | Retrieve detailed information of a specific dispute | low |
| accept_dispute_claim | Accept a dispute claim | high |
| create_shipment_tracking | Create a shipment tracking record | medium |
| get_shipment_tracking | Retrieve shipment tracking information | low |
| update_shipment_tracking | Update shipment tracking information | medium |
| create_product | Create a new product in the PayPal catalog | medium |
| list_products | List products with optional pagination and filtering | low |
| show_product_details | Retrieve details of a specific product | low |
| create_subscription_plan | Create a new subscription plan | medium |
| list_subscription_plans | List subscription plans | low |
| show_subscription_plan_details | Retrieve details of a specific subscription plan | low |
| create_subscription | Create a new subscription | medium |
| show_subscription_details | Retrieve details of a specific subscription | low |
| update_subscription | update an existing subscription | medium |
| cancel_subscription | Cancel an active subscription | high |
| list_transactions | List transactions with optional pagination and filtering | low |
| get_merchant_insights | Retrieve business intelligence metrics and analytics for a merchant | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›What are the environment requirements for this toolkit?
You must be running Node.js version 18 or higher.
›How do I toggle between sandbox and production environments?
You can enable sandbox mode by setting context in your configuration to sandbox: true, or by setting the PAYPAL_ENVIRONMENT environment variable to SANDBOX or PRODUCTION.
›What credentials are required to initialize the toolkit?
You need a PayPal client ID and client secret, which can be retrieved from your PayPal Developer Dashboard.
›What types of accounts are needed for different environments?
You need a PayPal Developer account to access the sandbox environment, and a PayPal Business account if you intend to use the production environment.
›Can I restrict which PayPal tools are available to the AI agent?
Yes, you can configure specific actions for modules like invoices, products, subscriptions, and disputes within the toolkit's configuration object.
Alternatives
Changelog
- ImprovedRelease 1.8.0
2025-09-15
- ImprovedRelease 1.7.0
2025-08-29
Badge
Maintain this server? Add the live badge to your README.