Recurly MCP. Control accounts, subscriptions, and invoices via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Recurly MCP Server connects your AI client directly to your subscription billing platform. Your agent can manage accounts, adjust subscriptions, and pull invoice data without leaving your chat interface.
It gives your AI the autonomy to read customer profiles via `get_account_details`, list all active plans with `list_catalog_plans`, or even cancel a recurring charge using `cancel_subscription`.
This is pure billing ops automation.
What your AI agents can do
Cancel subscription
Immediately cancels an active subscription; this action is irreversible.
Create account
Creates a new customer billing account using provided code, email, and name details.
Create subscription
Sets up a new recurring subscription for an existing customer account.
The agent can list all customers, retrieve full billing profiles (get_account_details), and create entirely new customer records with create_account.
You can read current subscription status (get_subscription_details) or execute major lifecycle changes: creating, canceling, or reactivating a plan instance.
The agent retrieves full lists of historical invoices (list_invoices) and pulls all available billing models from the catalog with list_catalog_plans.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Recurly MCP Server: 10 Tools for Billing & Account Ops
These ten tools let your agent manage the entire billing lifecycle—from creating accounts to canceling subscriptions and retrieving historical invoices.
019d75fdcancel subscription
Immediately cancels an active subscription; this action is irreversible.
019d75fdcreate account
Creates a new customer billing account using provided code, email, and name details.
019d75fdcreate subscription
Sets up a new recurring subscription for an existing customer account.
019d75fdget account details
Retrieves all core billing and profile information for a specific customer account ID.
019d75fdget subscription details
Pulls the current status, renewal date, and plan specifics for one given subscription ID.
019d75fdlist accounts
Provides a directory listing of all customer accounts managed within Recurly.
019d75fdlist catalog plans
Retrieves the full list and details of every available product plan model in your catalog.
019d75fdlist invoices
Generates a chronological list of all financial invoices that have been processed by Recurly.
019d75fdlist subscriptions
Lists every subscription instance managed in the system, providing a high-level overview of current recurring revenue sources.
019d75fdreactivate subscription
Brings back a subscription that was previously cancelled or expired without needing manual intervention.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Recurly, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You're connecting Recurly—your whole subscription billing engine—straight into your AI client. Your agent doesn't need to jump between UIs anymore; it manages accounts, adjusts subscriptions, and pulls invoice history right from the chat window. This is pure operational power for billing, period.
Managing Customer Accounts
Your agent can handle customer data like a pro. It retrieves a directory listing of every account you manage using list_accounts. If you need deep background on one person, your AI client uses get_account_details to pull all the core billing and profile info tied to a specific customer ID. Need to onboard someone new? Your agent handles that with create_account, letting you provide the required code, email, and name details to establish a brand-new billing record.
Controlling Subscriptions
The agent gives you total control over recurring revenue streams. You can read the current state of any plan instance by calling get_subscription_details; this pulls the status, when it renews, and what specific plan model is running. To start a user on a paid service, your agent executes create_subscription for an existing customer account.
When a subscription needs to be killed, cancel_subscription immediately stops the recurring charge; remember, that action's irreversible. If a client falls off the wagon but shouldn't, your agent brings them back with reactivate_subscription. To get a high-level overview of all active revenue sources, you can call list_subscriptions, which lists every subscription instance managed in the system.
Billing Records and Plans Catalog
The server handles all your financial data. If you need to verify payments or audit past charges, calling list_invoices generates a complete, chronological list of every invoice Recurly has processed for you. For understanding what products you're selling, the agent uses list_catalog_plans to retrieve the full details and list of every available product plan model in your entire catalog.
The system also provides comprehensive oversight by allowing your client to pull a full directory listing of all customer accounts via list_accounts, which is foundational for any billing task.
How Recurly MCP Works
- 1 Add the Recurly MCP server to your authorized module list.
- 2 Configure the server using your specific Recurly subdomain and Private API Key.
- 3 Talk naturally to your AI client. It detects the billing task (e.g., 'cancel this sub') and executes the necessary tool call.
The bottom line is: you talk to your AI agent, and it handles the complex API calls to Recurly for you.
Who Is Recurly MCP For?
RevOps teams who spend hours clicking between dashboards; Customer Support Agents stuck on billing questions they can't answer; or developers needing safe, controlled access to live billing data. This is for anyone whose job involves high-volume account lifecycle management and needs it fast.
You run reports by asking the AI to list subscriptions or pull historical invoices, getting clean data without building complex queries.
A customer calls about a payment issue. You use the agent to check get_account_details and instantly see if they have past due balances or an active plan status, resolving it mid-chat.
You test provisioning logic by listing available plans (list_catalog_plans) or simulating account changes using create_account before hitting production code.
What Changes When You Connect
- Cancel billing instantly. Instead of navigating deep into the vendor console to end a service, you just ask your agent to
cancel_subscriptionwith an ID. It handles the irreversible change immediately. - Full account visibility. Need to know if 'Alpha Corp' is good? Use
get_account_details. You get their current subscription status and payment history in one go, bypassing multiple dashboard clicks. - Zero context switching for billing. Whether you need to check old payments via
list_invoicesor activate a new plan usingcreate_subscription, the entire operation stays inside your chat window. - Manage the full lifecycle. If a customer's sub lapses, don't escalate it. Ask the agent to run
reactivate_subscription. It handles re-enrolling them based on their existing profile. - Understand your inventory. Want to know what plans you sell? Call
list_catalog_plansto see all available models without manually browsing the product setup pages.
Real-World Use Cases
Diagnosing a Failed Payment
A customer calls: 'My service stopped.' The support agent asks the AI to run get_account_details for their ID. The agent reports they are suspended, and the engineer runs reactivate_subscription. Problem solved in minutes without leaving the chat.
Onboarding a New Client
The sales team finalizes a deal. They ask the AI to first run create_account with the client's details, and then immediately follow up by calling create_subscription using the 'Premium Tier' ID they found via list_catalog_plans.
Auditing Revenue Loss
The RevOps team needs to see all subs that expired last month. They ask the agent to run list_subscriptions, filter for 'Expired', and then use the list IDs to bulk-check their status before planning re-engagement campaigns.
Handling Immediate Cancellations
A client is leaving early. The agent confirms the account via get_account_details, then immediately runs cancel_subscription. All necessary billing changes are logged and confirmed without needing a human to click 'Submit' on three different forms.
The Tradeoffs
Assuming basic listing is enough
Just running list_accounts gives you IDs, but it doesn't tell you if the account has an active subscription or how much money was owed.
→
Always follow up a list call with targeted reads. After list_accounts, use get_account_details and then get_subscription_details to build a complete, actionable profile.
Ignoring the Plan Catalog
Trying to create a subscription without knowing if the plan ID is still valid or has changed name.
→
Before running create_subscription, always check the current product options by calling list_catalog_plans. This verifies your inputs against the live data.
Manual Process for Status Checks
Manually pulling 50 invoices from a UI export and cross-referencing them with payment gateway records.
→
Use list_invoices to pull the exact data set you need directly into your agent's output, saving hours of manual copy/pasting.
When It Fits, When It Doesn't
Use this MCP Server if your core pain point is billing state management and account lifecycle operations. If you frequently need to read an account profile (e.g., 'What is the current status?') or perform irreversible actions (e.g., cancel_subscription), this server gives you that control.
Don't use it if your primary goal is simple CRM data entry, like updating a phone number which doesn't affect billing. For pure contact management, a generic identity tool might suffice. If you only need to read basic user information (Name, Email), get_account_details handles that. But if the action involves money—creation, cancellation, or reactivating—you need this Recurly integration.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Recurly. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Billing issues shouldn't require switching between five different tabs.
Today, diagnosing a single billing problem is a nightmare. You start on the support dashboard, copy an account ID; then you switch to the subscription portal to check status; next, you go to the invoicing section to see payment history. This means 4-5 tabs open, multiple copies of data in your clipboard, and half the time, you're looking at outdated views.
With this MCP server, it’s all one conversation. You ask: 'Check account X.' The agent runs `get_account_details` and instantly reports everything—status, payment history, active plans. The process is contained, reliable, and fast.
Recurly MCP Server gives you immediate control over subscription status.
Manual workflows for billing often involve a chain: Find the customer ID -> Confirm they are suspended -> Manually initiate reactivation -> Wait for system confirmation. This process takes several clicks and involves human error at every step.
Now, you tell your agent to reactivate the account using `reactivate_subscription`. The server handles the full sequence of API calls required in a single command. It’s direct control over complex state changes.
Common Questions About Recurly MCP
How do I check if an account is active before creating a new subscription using `get_account_details`? +
First, run get_account_details with the customer ID. This returns their current billing status and any existing subscriptions. Only proceed to create_subscription if the details show they are eligible for a new plan.
What is the difference between `list_subscriptions` and `list_accounts`? +
list_accounts gives you a directory of all customer profiles (the people). list_subscriptions lists every individual recurring service instance attached to those accounts (the actual services).
Can I cancel a subscription without knowing the specific plan name? Use `cancel_subscription`? +
No, you typically need the unique Subscription ID for cancel_subscription. First, run get_subscription_details to retrieve the exact identifier before sending the cancellation command.
What if I want to see every invoice ever generated? Should I use `list_invoices`? +
Yes, list_invoices is the tool for this. It pulls a chronological list of all billing records from the system. You can filter that output by date or status in your prompt.
Do I need to manually create an account before running `create_subscription`? +
Yes, you must first run create_account and ensure the account exists with a valid ID. The subscription tool needs an existing billing container to attach the new service.
If I run `get_subscription_details` for a subscription ID that doesn't exist, how does the tool handle the error? +
The tool returns a structured API error object instead of failing silently. You check the response body directly; it will contain an explicit failure code (like 404) and details stating the resource was not found.
When I use `list_accounts` and have thousands of customers, how do I handle pagination to get all data? +
The tool uses cursor-based pagination. To retrieve everything, you must pass the 'next page' or last returned ID/cursor from one response into the subsequent call until no further records are listed.
What is the technical difference between running `cancel_subscription` and using `reactivate_subscription`? +
Cancellation immediately flags the account for termination, stopping future billing cycles. Reactivation reverses that status change, restoring active payment mandates and ensuring continuous service eligibility.
How do I find my Subdomain and API Key? +
Your subdomain is the first part of your Recurly portal URL (e.g., if you log in at myproject.recurly.com, your subdomain is myproject). To get your API Key, navigate inside Recurly to Integrations > API Credentials and generate or copy your 'Private API Key'.
Can it accidentally charge my customers? +
While the server can manage subscriptions (e.g., setting up a customer with a plan), it strictly follows the billing logic predefined in your Recurly catalog settings. It doesn't bypass credit card validation or execute arbitrary charges directly without a plan context.
Does cancelling a subscription remove the account entirely? +
No, using cancel_subscription stops future renewals for that specific plan item instance. The underlying user billing account remains intact and can hold other valid subscriptions or past invoices.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Corpay One
Simplify business payments with automated AP processing, virtual cards, and vendor management that saves your finance team hours.
Alipay Open Platform
Automate payment workflows via Alipay — create trades, process refunds, execute fund transfers, and reconcile billing ledgers natively from any AI agent.
Klarna
Manage payment sessions, orders, and fulfillment via the Klarna REST API.
You might also like
Copper CRM
Equip your AI agent to manage leads, people, and sales opportunities directly within Copper CRM.
JD Cloud / 京东云
China's leading supply chain cloud platform — manage VMs, storage, and cloud infrastructure via AI.
ShipEngine
Compare shipping rates, print labels, and track packages across UPS, FedEx, USPS, and dozens of global carriers instantly.