stripe_list_subscriptions
Pack: stripe_connect · Endpoint: https://gateway.pipeworx.io/stripe_connect/mcp
List active subscriptions.
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 |
status | string | no | Filter by status (active, canceled, past_due, etc.) |
Example call
Arguments
{
"_apiKey": "your-stripe_connect-api-key",
"status": "active"
}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_subscriptions","arguments":{"_apiKey":"your-stripe_connect-api-key","status":"active"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('stripe_list_subscriptions', {
"_apiKey": "your-stripe_connect-api-key",
"status": "active"
});More examples
{
"_apiKey": "your-stripe_connect-api-key",
"customer": "cus_ABC123",
"status": "active",
"limit": 15
}Response shape
| Field | Type | Description |
|---|---|---|
object | string | Object type (list) |
data | array | Array of subscription 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 subscription objects",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Subscription ID"
},
"object": {
"type": "string",
"description": "Object type (subscription)"
},
"application": {
"type": [
"string",
"null"
],
"description": "Application ID"
},
"automatic_tax": {
"type": "object",
"description": "Automatic tax settings"
},
"billing_cycle_anchor": {
"type": "integer",
"description": "Billing cycle anchor timestamp"
},
"billing_thresholds": {
"type": [
"object",
"null"
],
"description": "Billing thresholds"
},
"cancel_at": {
"type": [
"integer",
"null"
],
"description": "Cancel at timestamp"
},
"cancel_at_period_end": {
"type": "boolean",
"description": "Cancel at period end"
},
"canceled_at": {
"type": [
"integer",
"null"
],
"description": "Canceled at timestamp"
},
"collection_method": {
"type": "string",
"description": "Collection method"
},
"created": {
"type": "integer",
"description": "Creation timestamp"
},
"currency": {
"type": "string",
"description": "Currency code"
},
"current_period_end": {
"type": "integer",
"description": "Current period end timestamp"
},
"current_period_start": {
"type": "integer",
"description": "Current period start timestamp"
},
"customer": {
"type": "string",
"description": "Customer ID"
},
"days_until_due": {
"type": [
"integer",
"null"
],
"description": "Days until due"
},
"default_payment_method": {
"type": [
"string",
"null"
],
"description": "Default payment method ID"
},
"default_source": {
"type": [
"string",
"null"
],
"description": "Default source ID"
},
"default_tax_rates": {
"type": "array",
"description": "Default tax rates"
},
"description": {
"type": [
"string",
"null"
],
"description": "Subscription description"
},
"discount": {
"type": [
"object",
"null"
],
"description": "Applied discount"
},
"ended_at": {
"type": [
"integer",
"null"
],
"description": "Ended at timestamp"
},
"items": {
"type": "object",
"description": "Subscription items list"
},
"latest_invoice": {
"type": [
"string",
"null"
],
"description": "Latest invoice ID"
},
"livemode": {
"type": "boolean",
"description": "Live mode"
},
"metadata": {
"type": "object",
"description": "Custom metadata"
},
"next_pending_invoice_item_invoice": {
"type": [
"integer",
"null"
],
"description": "Next pending invoice timestamp"
},
"on_behalf_of": {
"type": [
"string",
"null"
],
"description": "On behalf of account ID"
},
"pause_collection": {
"type": [
"object",
"null"
],
"description": "Pause collection settings"
},
"payment_settings": {
"type": "object",
"description": "Payment settings"
},
"pending_invoice_item_interval": {
"type": [
"object",
"null"
],
"description": "Pending invoice item interval"
},
"pending_setup_intent": {
"type": [
"string",
"null"
],
"description": "Pending setup intent ID"
},
"pending_update": {
"type": [
"object",
"null"
],
"description": "Pending update"
},
"schedule": {
"type": [
"string",
"null"
],
"description": "Schedule ID"
},
"start_date": {
"type": "integer",
"description": "Start date timestamp"
},
"status": {
"type": "string",
"description": "Subscription status"
},
"test_clock": {
"type": [
"string",
"null"
],
"description": "Test clock ID"
},
"transfer_data": {
"type": [
"object",
"null"
],
"description": "Transfer data"
},
"trial_end": {
"type": [
"integer",
"null"
],
"description": "Trial end timestamp"
},
"trial_settings": {
"type": [
"object",
"null"
],
"description": "Trial settings"
},
"trial_start": {
"type": [
"integer",
"null"
],
"description": "Trial start timestamp"
}
}
}
},
"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.