mcp-paypal mcp

v1.0.0 · MCP Tool · finance · registry.pascalai.org

PayPal REST API v2. Requires clientId and secret from developer.paypal.com. Supports sandbox mode. Operations: create_order, capture_order, get_order, list_transactions, create_payout, get_payout, create_invoice, list_invoices, list_subscriptions, get_subscription.

paypalpaymentsfinanceordersecommerce

Input Parameters

ParameterTypeDescription
operationrequired string Operation to perform. One of: create_order, capture_order, get_order, list_transactions, create_payout, get_payout, create_invoice, list_invoices, list_subscriptions, get_subscription.
clientIdrequired string PayPal app client ID.
secretrequired string PayPal app secret.
sandboxoptional boolean Use sandbox environment (default: true). Default: True.
orderIdoptional string Order ID for capture_order, get_order.
amountoptional string Amount string for create_order (e.g. '10.00').
currencyoptional string Currency code for create_order (default: USD). Default: USD.
descriptionoptional string Order/invoice description.
returnUrloptional string Return URL after payer approval.
cancelUrloptional string Cancel URL if payer cancels.
payoutItemsoptional string JSON array of payout items for create_payout.
batchIdoptional string Payout batch ID for get_payout.
invoiceIdoptional string Invoice ID for get operations.
recipientoptional string Recipient email for payout.
subIdoptional string Subscription ID for get_subscription.
bodyoptional string Raw JSON body for advanced operations.
pageSizeoptional integer Results per page (default: 10). Default: 10.
pageoptional integer Page number (default: 1). Default: 1.

Output Fields

FieldTypeDescription
order object
payout object
invoice object
invoices array[object]
transactions array[object]
approvalUrl string
ok boolean
error string

Examples

Create a PayPal order

// Input
{
  "operation": "create_order",
  "clientId": "xxx",
  "secret": "yyy",
  "sandbox": true,
  "amount": "19.99",
  "currency": "USD",
  "description": "Premium subscription"
}

// Output
{
  "order": {
    "id": "ORDER123",
    "status": "CREATED"
  },
  "approvalUrl": "https://www.sandbox.paypal.com/..."
}

Install & Discovery

Install

ppm install mcp-paypal

Get JSON Schema

GET /v1/packages/mcp-paypal/1.0.0/schema

Discover by keyword

GET /v1/mcp/discover?q=paypal
Discovery hint: Install with ppm install mcp-paypal or invoke remotely via POST /v1/invoke/mcp-paypal on the MCP Service.

PascalAI Usage

uses toolslib;
var Tool := LoadTool('mcp-paypal');
var R := Tool.Call(JsonObj(['operation','create_order','clientId','xxx','secret','yyy','sandbox',True,'amount','9.99','currency','USD']));
Writeln(R.ToJSON);