List subscriptions

List subscriptions

Returns subscriptions filtered by status, customer or price; with no status it returns every subscription that is not canceled.

Set up

Use the first option your agent supports.

MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

{ "mcpServers": { "stripe": { "url": "https://mcp.stripe.com" } } }

Call the MCP tool stripe_api_read with GET /v1/subscriptions.

Server URL: https://mcp.stripe.com

CLI (official)

Install the command and sign in with it, then confirm it runs.

npm install -g @stripe/cli
stripe --version

Run stripe subscriptions list.

API (official)

• Base URL: https://api.stripe.com
• Endpoint: GET /v1/subscriptions
• Auth: send the header Authorization: Bearer $STRIPE_API_KEY
• Get a key: https://dashboard.stripe.com/apikeys
• Docs: https://docs.stripe.com/api

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
• Never print API keys.