Recurly MCP server. MCP server for Recurly — accounts, subscriptions, invoices, plans; cancel & pause subs.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"recurly": {
"url": "https://recurly.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
recurly_list_accounts | read | List accounts List customer accounts on the site. Supports cursor pagination and filtering. Recurly: GET /accounts. |
recurly_get_account | read | Get account Fetch one account by its id (no prefix, e.g. e28zov4fw0v2) or by your own code prefixed with `code-` (e.g. code-bob). Recurly: GET /accounts/{account_id}. |
recurly_list_subscriptions | read | List subscriptions List subscriptions across the site, optionally scoped to one account and/or filtered by state. Provide `account_id` to use GET /accounts/{account_id}/subscriptions; otherwise GET /subscriptions. |
recurly_get_subscription | read | Get subscription Fetch one subscription by its id (no prefix) or by uuid prefixed with `uuid-`. Recurly: GET /subscriptions/{subscription_id}. |
recurly_list_invoices | read | List invoices List invoices across the site, or for one account when `account_id` is given (GET /accounts/{account_id}/invoices). Recurly: GET /invoices. |
recurly_list_plans | read | List plans List the site's subscription plans, optionally filtered by state. Recurly: GET /plans. |
recurly_cancel_subscription | write | Cancel subscription (WRITE — changes billing) Cancel a subscription. By default it stays active until the end of the current term (`term_end`); pass timeframe `bill_date` to cancel effective the next bill date. This changes billing state. Recurly: PUT /subscriptions/{subscription_id}/cancel. |
recurly_pause_subscription | write | Pause subscription (WRITE — changes billing) Pause a subscription for a number of upcoming billing cycles. Set `remaining_pause_cycles` to 0 to resume/cancel an existing pause. This changes billing state. Recurly: PUT /subscriptions/{subscription_id}/pause. |
recurly_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
recurly_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Recurly tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Pro | $9/mo · $90/yr | Unlimited |
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.