Create a plan with POST /sites/SITE_ID/plans; supply code (unique string identifier), name, currencies array with currency and unit_amount, and interval_unit (months or days) plus interval_length
Create an account with POST /sites/SITE_ID/accounts providing code (your internal customer ID), email, and billing_info.token_id from Recurly.js client-side tokenization
Enroll the account in the plan with POST /sites/SITE_ID/subscriptions using account.code, plan_code, currency, and optionally trial_ends_at (ISO 8601)
Retrieve the subscription with GET /sites/SITE_ID/subscriptions/SUBSCRIPTION_ID; check state field which can be active, canceled, expired, or future
List a customer's subscriptions with GET /sites/SITE_ID/accounts/ACCOUNT_CODE/subscriptions
Cancel a subscription with DELETE /sites/SITE_ID/subscriptions/SUBSCRIPTION_ID which schedules cancellation at period end by default; pass body {timeframe: 'now'} for immediate termination
Known gotchas
Recurly's current REST API version is v2021-02-25 — always pin the API version in the Recurly-Version request header to avoid breaking changes from automatic version upgrades
The plan code is immutable after creation; changing it requires creating a new plan and migrating subscribers — choose codes carefully in production
Recurly's site ID appears in all API paths as /sites/SITE_ID/; the SITE_ID can be found in the Recurly dashboard URL (e.g., app.recurly.com/go/SITE_ID)
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp