usefulapi

Recurly MCP server. MCP server for Recurly — accounts, subscriptions, invoices, plans; cancel & pause subs.

Claude

  1. Open Settings → Connectors → Add custom connector
  2. Paste this URL:
    https://recurly.usefulapi.io/mcp
  3. Authenticate with Recurly when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "recurly": {
      "url": "https://recurly.usefulapi.io/mcp"
    }
  }
}
live10 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 10

ToolTypeWhat it does
recurly_list_accountsread
List accounts
List customer accounts on the site. Supports cursor pagination and filtering. Recurly: GET /accounts.
recurly_get_accountread
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_subscriptionsread
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_subscriptionread
Get subscription
Fetch one subscription by its id (no prefix) or by uuid prefixed with `uuid-`. Recurly: GET /subscriptions/{subscription_id}.
recurly_list_invoicesread
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_plansread
List plans
List the site's subscription plans, optionally filtered by state. Recurly: GET /plans.
recurly_cancel_subscriptionwrite
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_subscriptionwrite
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_statusmeta
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_upgrademeta
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.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro$9/mo · $90/yrUnlimited

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.