Pby Paddle
Get MRR metrics
Returns daily monthly recurring revenue totals between two dates, counting new subscriptions, upgrades, downgrades and churn.
Description
`from` and `to` are required RFC 3339 dates; passing the same date for both returns an empty series. The totals leave out one-time payments and Paddle fees. An API key needs the `metrics.read` permission. On the MCP server, run it with `execute`.
get-mrr-metrics.md
Get MRR metrics
Returns daily monthly recurring revenue totals between two dates, counting new subscriptions, upgrades, downgrades and churn.
from and to are required RFC 3339 dates; passing the same date for both
returns an empty series. The totals leave out one-time payments and Paddle
fees. An API key needs the metrics.read permission. 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 /metrics/monthly-recurring-revenue - 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.