Recurly
Recurly is a subscription management and recurring billing platform for managing customers, plans, subscriptions, invoices, payments, and revenue operations.
Verdict
Common use cases
- Answer billing questions during support chats
- Audit subscription plan pricing before sales calls
- Check invoice status for overdue accounts
- Verify catalog item tax settings
- Confirm sandbox versus production API context
Integration
- Vendor
- Recurly
- Category
- other
- Auth
- API_KEY
- Tools
- 10
- Composio slug
recurly
Tools
- Get Account
Fetch one Recurly customer account by opaque ID or account code. Prefix an account code with code-, for example code-customer_123; do not prefix an opaque ID.
- Get Item
Fetch one Recurly catalog item by opaque ID or item code. Prefix a code with code-, for example code-red; do not prefix an opaque ID.
- Get Plan
Fetch one Recurly subscription plan by opaque ID or plan code. Prefix a code with code-, for example code-gold; do not prefix an opaque ID.
- List Accounts
Find customer accounts on the Recurly site by email or subscription and past-due status. Returns one page and account identifiers that other tools can consume.
- List Invoices
List invoices by state or invoice type to inspect billed amounts, balances, and account or subscription references without changing invoice state.
- List Items
List reusable catalog items on the connected Recurly site, including codes, state, tax settings, and currency pricing.
- List Plans
List subscription plans and their pricing configuration on the connected Recurly site.
- List Sites
List Recurly sites visible to the connected private API key, including each site's ID, subdomain, mode, currencies, and enabled features. Use this first to confirm sandbox versus production context.
- List Subscriptions
List subscriptions and filter by lifecycle state without creating, changing, pausing, canceling, or billing a subscription.
- List Transactions
List payment transactions by type and success status for read-only payment investigation. This tool never authorizes, captures, purchases, cancels, or refunds funds.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add Integration', search for Recurly, and select it. 3. In a separate browser tab, log into your Recurly account, go to Integrations > API Credentials, and generate a new private API key with read-only scopes. 4. Copy the key and paste it into the Switchy connection dialog, then click 'Connect'. 5. Switchy will validate the key and display which Recurly site (sandbox or production) it accesses. 6. Open any Project, type '@Recurly list sites' in the chat, and confirm the response shows your expected site ID and mode. 7. To fetch a specific account, use '@Recurly get account code-customer_123' (prefix account codes with 'code-', leave opaque IDs as-is). 8. Test an invoice query with '@Recurly list invoices' to verify the connection pulls live data.
What teammates see: by default, memories from Recurly are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Account Billing Summary
@Recurly get account code-acme_corp and then list the last five invoices for that account, showing state and balance due
Plan Pricing Comparison
@Recurly list plans and show each plan code, name, and pricing in USD so I can compare our subscription tiers
Overdue Account Audit
@Recurly list accounts with past_due status true and show account codes, emails, and subscription states
Catalog Item Lookup
@Recurly get item code-premium_support and tell me its state, tax settings, and price in all configured currencies
Site Mode Verification
@Recurly list sites and highlight which mode each site is in, plus the currencies and features enabled
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@recurly list all accounts with past-due subscriptions so I can see who needs a payment reminder this week
The MCP returned 7 past-due accounts. Each entry includes the account code, email, balance, and subscription state. For example, account code-acme_corp has a $450 outstanding balance with subscription state 'past_due' since March 3. Account code-startup_xyz shows $120 overdue since March 1. The list includes opaque account IDs you can pass to other tools to fetch full details or update billing information.
This example demonstrates read-only filtering by subscription status. The MCP returns one page at a time; if you have hundreds of past-due accounts you'll need to handle pagination. Requires read scope on accounts and subscriptions. No billing state is changed by this query.
@recurly get the full details for account code-customer_456 including current subscription and payment method on file
The MCP fetched account code-customer_456. The response shows email support@example.com, billing address in San Francisco, current balance $0, and one active subscription on plan code-premium_monthly at $99/month. Payment method is a Visa ending in 4242, expiring 12/2025. The account was created January 15, 2024 and has no outstanding invoices.
This example shows deep account inspection using an account code (prefixed with 'code-'). If you have an opaque ID instead, omit the prefix. The MCP does not return full credit card numbers for PCI compliance. Useful for support workflows where you need subscription and payment context in one call.
@recurly list all active subscription plans with their monthly pricing, then draft a comparison table for our sales team showing which features are in each tier
The MCP returned 4 active plans: Basic ($29/month), Pro ($79/month), Premium ($149/month), and Enterprise (custom pricing). Each entry includes the plan code, billing interval, setup fees, and trial period configuration. The AI then synthesized a markdown table comparing trial length (7 days for Basic/Pro, 14 days for Premium), setup fees ($0 across all tiers), and monthly cost. The table notes that Enterprise pricing requires a sales call.
This example pairs the MCP's list-plans tool with the AI's reasoning to produce a formatted artifact. The MCP returns pricing and metadata; the AI infers structure. If your plans include add-ons or usage-based components, those appear in separate fields and may need additional synthesis.
Use-case deep-dives
When Recurly MCP closes the loop on billing escalations
A five-person support team fields 20-30 billing questions daily—most are 'why did my card decline' or 'what am I paying for.' The Recurly MCP wins here because your team can pull account status, invoice history, and active plan details in one Switchy thread without toggling to the Recurly dashboard. List Accounts by email, grab the invoice list, confirm the subscription plan—all in 90 seconds. The trade-off: if you need to issue refunds or update payment methods, you still jump to Recurly's UI; this MCP is read-only. If your escalation rate is under 10 per day and you just need context fast, connect this MCP and let support answer billing questions without leaving the chat.
How Recurly MCP speeds up small-team finance close
A two-person finance team at a 50-subscription SaaS closes books monthly and needs to tie invoice totals to Stripe deposits. The Recurly MCP handles the lookup layer: List Invoices by state to pull all 'paid' invoices for the month, spot-check account codes against your spreadsheet, and confirm plan pricing matches what you billed. You avoid exporting CSVs or clicking through 50 invoice pages. The boundary: if you run more than 200 invoices per month, pagination becomes tedious and you should export from Recurly's reporting UI instead. Below that threshold, this MCP turns reconciliation from a two-hour slog into a 20-minute Switchy session.
When Recurly MCP clarifies plan structure before you ship
A four-person product team is designing a new pricing tier and needs to audit what plans and items already exist in production. The Recurly MCP's List Plans and List Items tools let you pull the full catalog into a Switchy thread, compare currency pricing across regions, and spot orphaned plans or duplicate item codes before you create the new tier. This beats opening ten Recurly tabs and copy-pasting into a Google Doc. The catch: if your catalog has more than 30 plans or you need to model revenue impact, you still need a spreadsheet or BI tool. For teams under 20 plans who just want a clean snapshot to inform the design, this MCP delivers the context in one query.
Frequently asked
What does the Recurly MCP let me do in Switchy?
It pulls subscription and billing data from your Recurly account into Switchy conversations. You can look up customer accounts, check invoice statuses, review plan pricing, and inspect catalog items without opening the Recurly dashboard. The MCP reads data—it won't create subscriptions or charge cards.
Do I need admin access to connect Recurly?
You need a private API key from Recurly, which typically requires admin or developer permissions on your Recurly site. The key determines whether you're connecting to sandbox or production, so confirm the environment before sharing it with your team in Switchy.
Can the Recurly MCP update subscriptions or refund invoices?
No. This integration is read-only. You can list accounts, plans, invoices, and items, but you can't modify subscriptions, issue refunds, or change billing details. For write operations, use Recurly's dashboard or their full REST API.
Why use this instead of logging into Recurly directly?
Speed and context. When a customer question lands in Switchy, you can pull their account balance, active plan, and recent invoices in the same thread—no tab-switching or copy-pasting IDs. It's faster for support and finance teams who answer billing questions all day.
Who on my team should connect the Recurly MCP?
Whoever handles subscription support or revenue operations. Because the API key grants read access to all customer billing data, limit it to team members who already work in Recurly. One connection covers the whole Switchy workspace.