Home / Servers / Stripe API / get_subscriptions

List subscriptions

An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.

List subscriptions By default, returns a list of subscriptions that have not been canceled. In order to list canceled subscriptions, specify status=canceled . [GET /v1/subscriptions]

Name on the gateway: stripe_api__get_subscriptions · read-only.

Parameters

NameTypeDescription
automatic_taxobjectFilter subscriptions by their automatic tax settings.
collection_methodcharge_automatically | send_invoiceThe collection method of the subscriptions to retrieve. Either…
createdobjectOnly return subscriptions that were created during the given date interval.
current_period_endobjectOnly return subscriptions whose minimum item current_period_end falls within…
current_period_startobjectOnly return subscriptions whose maximum item current_period_start falls within…
customerstringThe ID of the customer whose subscriptions you're retrieving.
customer_accountstringThe ID of the account representing the customer whose subscriptions you're…
ending_beforestringA cursor for use in pagination. ending_before is an object ID that defines…
expandarraySpecifies which fields in the response should be expanded.
limitintegerA limit on the number of objects to be returned. Limit can range between 1 and…
pricestringFilter for subscriptions that contain this recurring price ID.
starting_afterstringA cursor for use in pagination. starting_after is an object ID that defines…
statusactive | all | canceled | ended | incomplete | incomplete_expired | past_due | paused | trialing | unpaidThe status of the subscriptions to retrieve. Passing in a value of canceled…
test_clockstringFilter for subscriptions that are associated with the specified test clock.…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "stripe_api__get_subscriptions",
  "arguments": {}
}

Or connect the Stripe API server directly, which lists 606 tools including this one:

Run in your terminal
claude mcp add --transport http hj-stripe-api https://mcp.hjlabs.in/mcp/stripe-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the list subscriptions tool with automatic_tax set to ….

More from Stripe API