Pby Paddle
List customers
Returns active customers, or only those whose email exactly matches one of the addresses you pass.
Description
Pass up to 100 addresses in `email` as a comma-separated list, or `status=archived` for archived customers. Use the returned customer ID as `customer_id` when listing subscriptions or transactions. On the MCP server, run it with `execute`.
list-customers.md
List customers
Returns active customers, or only those whose email exactly matches one of the addresses you pass.
Pass up to 100 addresses in email as a comma-separated list, or
status=archived for archived customers. Use the returned customer ID as
customer_id when listing subscriptions or transactions. On the MCP server,
run it with execute.
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.
Server URL: https://mcp.paddle.com/mcp
API (official)
- Base URL: https://api.paddle.com
- Endpoint:
GET /customers - 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 doing anything else, make one read-only call to confirm access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.
Built from these files in the repository
The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.