stripe_list_charges
Pack: stripe_connect · Endpoint: https://gateway.pipeworx.io/stripe_connect/mcp
List recent charges.
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.