List subscriptions
Subscriptions with plan, state, quantity, price and renewal dates.
MCP tool recurly_read → list_subscriptions
read
Lists subscriptions, 50 per page by default and up to 200. Filter by state; past_due returns active or canceled subscriptions that have an overdue invoice. Each item has the subscription_id for the write tools, the plan code, the unit amount in cents and the current period end.
Parameters
| Name | Type | Description |
|---|---|---|
| state enum | enum | active, canceled, expired, future, in_trial, live or past_due. Default: all. |
| per_page integer | integer | 1 to 200. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "recurly_read",
"arguments": {
"operation": "list_subscriptions",
"arguments": {
"state": "past_due",
"per_page": 50
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"subscriptions": [
{
"subscription_id": "44f83d0cbf86d2b8a5b3d3e6c3e8b16f",
"account_code": "acme-co",
"plan_code": "team",
"state": "active",
"quantity": 1,
"unit_amount_in_cents": 24000,
"currency": "USD",
"current_period_ends_at": "2026-11-14T00:00:00Z"
}
],
"total": 1,
"next_cursor": null
},
"isError": false
}