stripe_list_charges
Pack: stripe_connect · Endpoint: https://gateway.pipeworx.io/stripe_connect/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/stripe_list_charges for the schema, then POST the same URL with its arguments for the data.
List Stripe payment charges for your account, optionally filtered by customer ID. Returns charge ID, amount, currency, status, and timestamp. Supports limit (1-100) pagination.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
_apiKey | string | yes | Stripe secret or restricted API key (sk_…) |
limit | number | no | Max results (1-100, default 10) |
customer | string | no | Filter by customer ID |
Example call
Arguments
{
"_apiKey": "your-stripe_connect-api-key",
"limit": 25
}curl
curl -X POST https://gateway.pipeworx.io/stripe_connect/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"stripe_list_charges","arguments":{"_apiKey":"your-stripe_connect-api-key","limit":25}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('stripe_list_charges', {
"_apiKey": "your-stripe_connect-api-key",
"limit": 25
});More examples
{
"_apiKey": "your-stripe_connect-api-key",
"customer": "cus_ABC123",
"limit": 10
}Response shape
| Field | Type | Description |
|---|---|---|
object | string | Object type (list) |
data | array | Array of charge objects |
has_more | boolean | Whether more results exist |
url | string | API endpoint URL |
Full JSON Schema
{
"type": "object",
"properties": {
"object": {
"type": "string",
"description": "Object type (list)"
},
"data": {
"type": "array",
"description": "Array of charge objects",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Charge ID"
},
"object": {
"type": "string",
"description": "Object type (charge)"
},
"amount": {
"type": "integer",
"description": "Charge amount in cents"
},
"amount_captured": {
"type": "integer",
"description": "Amount captured in cents"
},
"amount_refunded": {
"type": "integer",
"description": "Amount refunded in cents"
},
"application": {
"type": [
"string",
"null"
],
"description": "Application ID"
},
"application_fee": {
"type": [
"string",
"null"
],
"description": "Application fee ID"
},
"application_fee_amount": {
"type": [
"integer",
"null"
],
"description": "Application fee amount"
},
"balance_transaction": {
"type": [
"string",
"null"
],
"description": "Balance transaction ID"
},
"billing_details": {
"type": "object",
"description": "Billing details"
},
"captured": {
"type": "boolean",
"description": "Charge captured"
},
"created": {
"type": "integer",
"description": "Creation timestamp"
},
"currency": {
"type": "string",
"description": "Currency code"
},
"customer": {
"type": [
"string",
"null"
],
"description": "Customer ID"
},
"description": {
"type": [
"string",
"null"
],
"description": "Charge description"
},
"destination": {
"type": [
"string",
"null"
],
"description": "Destination account"
},
"dispute": {
"type": [
"string",
"null"
],
"description": "Dispute ID"
},
"disputed": {
"type": "boolean",
"description": "Under dispute"
},
"failure_balance_transaction": {
"type": [
"string",
"null"
],
"description": "Failure balance transaction"
},
"failure_code": {
"type": [
"string",
"null"
],
"description": "Failure code"
},
"failure_message": {
"type": [
"string",
"null"
],
"description": "Failure message"
},
"fraud_details": {
"type": [
"object",
"null"
],
"description": "Fraud details"
},
"invoice": {
"type": [
"string",
"null"
],
"description": "Invoice ID"
},
"livemode": {
"type": "boolean",
"description": "Live mode"
},
"metadata": {
"type": "object",
"description": "Custom metadata"
},
"outcome": {
"type": "object",
"description": "Outcome details"
},
"paid": {
"type": "boolean",
"description": "Charge paid"
},
"payment_intent": {
"type": [
"string",
"null"
],
"description": "Payment intent ID"
},
"payment_method": {
"type": [
"string",
"null"
],
"description": "Payment method ID"
},
"payment_method_details": {
"type": "object",
"description": "Payment method details"
},
"receipt_email": {
"type": [
"string",
"null"
],
"description": "Receipt email"
},
"receipt_number": {
"type": [
"string",
"null"
],
"description": "Receipt number"
},
"receipt_url": {
"type": [
"string",
"null"
],
"description": "Receipt URL"
},
"refunded": {
"type": "boolean",
"description": "Charge refunded"
},
"refunds": {
"type": "object",
"description": "Refunds list object"
},
"review": {
"type": [
"string",
"null"
],
"description": "Review ID"
},
"shipping": {
"type": [
"object",
"null"
],
"description": "Shipping details"
},
"source": {
"type": "object",
"description": "Payment source"
},
"source_transfer": {
"type": [
"string",
"null"
],
"description": "Source transfer ID"
},
"statement_descriptor": {
"type": [
"string",
"null"
],
"description": "Statement descriptor"
},
"statement_descriptor_suffix": {
"type": [
"string",
"null"
],
"description": "Statement descriptor suffix"
},
"status": {
"type": "string",
"description": "Charge status"
},
"transfer_data": {
"type": [
"object",
"null"
],
"description": "Transfer data"
},
"transfer_group": {
"type": [
"string",
"null"
],
"description": "Transfer group"
}
}
}
},
"has_more": {
"type": "boolean",
"description": "Whether more results exist"
},
"url": {
"type": "string",
"description": "API endpoint URL"
}
}
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"stripe_connect": {
"url": "https://gateway.pipeworx.io/stripe_connect/mcp"
}
}
}See Getting Started for client-specific install steps.