`paypal_list_disputes`

Pack: paypal · Endpoint: https://gateway.pipeworx.io/paypal/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/paypal_list_disputes for the schema, then POST the same URL with its arguments for the data.

List chargebacks and claims against your account. Returns dispute IDs, amounts, statuses, and reasons.

Parameters

Name	Type	Required	Description
`_clientId`	string	yes	PayPal app Client ID
`_clientSecret`	string	yes	PayPal app Client Secret
`_sandbox`	boolean	no	Use sandbox environment (default: false)

Example call

Arguments

{
  "_clientId": "your-paypal-client-id",
  "_clientSecret": "your-paypal-client-secret"
}

curl

curl -X POST https://gateway.pipeworx.io/paypal/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"paypal_list_disputes","arguments":{"_clientId":"your-paypal-client-id","_clientSecret":"your-paypal-client-secret"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('paypal_list_disputes', {
  "_clientId": "your-paypal-client-id",
  "_clientSecret": "your-paypal-client-secret"
});

Response shape

Field	Type	Description
`items`	array	Array of disputes
`total_items`	number	Total number of disputes
`links`	array

Full JSON Schema

{
  "type": "object",
  "description": "List of disputes and chargebacks",
  "properties": {
    "items": {
      "type": "array",
      "description": "Array of disputes",
      "items": {
        "type": "object",
        "properties": {
          "dispute_id": {
            "type": "string",
            "description": "Dispute ID"
          },
          "status": {
            "type": "string",
            "description": "Dispute status (e.g., OPEN, RESOLVED, WAITING_FOR_BUYER_RESPONSE, WAITING_FOR_SELLER_RESPONSE)"
          },
          "reason": {
            "type": "string",
            "description": "Dispute reason code"
          },
          "reason_description": {
            "type": "string",
            "description": "Human readable dispute reason"
          },
          "create_time": {
            "type": "string",
            "description": "Dispute creation timestamp"
          },
          "update_time": {
            "type": "string",
            "description": "Dispute last update timestamp"
          },
          "amount": {
            "type": "object",
            "properties": {
              "currency_code": {
                "type": "string",
                "description": "Currency code"
              },
              "value": {
                "type": "string",
                "description": "Disputed amount"
              }
            }
          },
          "transaction_id": {
            "type": "string",
            "description": "Related transaction ID"
          }
        }
      }
    },
    "total_items": {
      "type": "number",
      "description": "Total number of disputes"
    },
    "links": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "href": {
            "type": "string"
          },
          "rel": {
            "type": "string"
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "paypal": {
      "url": "https://gateway.pipeworx.io/paypal/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

paypal_list_disputes