List subscriptions

List subscriptions

Returns subscriptions filtered by status, customer or price, 50 per page by default and up to 200.

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": { "paddle": { "url": "https://mcp.paddle.com/mcp" } } }

Call the MCP tool execute with GET /subscriptions.

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

API (official)

• Base URL: https://api.paddle.com
• Endpoint: GET /subscriptions
• Auth: send the header Authorization: Bearer $PADDLE_API_KEY
• Get a key: https://vendors.paddle.com/authentication-v2
• Docs: https://developer.paddle.com/api-reference/about

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.