Recurly MCP. Manage your billing accounts and invoices instantly.
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 automates subscription billing and account management by connecting your AI agent directly to Recurly's API. This server gives your client granular control over billing accounts, invoice history, product plans, and active subscriptions—all via natural conversation.
Manage revenue data, check payment statuses, or onboard new customers without leaving your chat window.
What your AI agents can do
Create billing account
Registers a new billing account within Recurly using required user information.
Get account details
Retrieves the current balance, status, and metadata for a specific billing account ID.
Get invoice
Fetches detailed information about one specific invoice by its unique ID.
List all active or expired subscriptions, retrieving specific metadata and plan details.
Retrieve detailed status information, balances, and metadata for any specified billing account ID.
Get payment history and current status details for specific invoice IDs.
Query the full catalog of available subscription plans and their associated pricing structures.
Register new customer billing accounts directly through an agent prompt, bypassing manual web form entry.
Retrieve financial data and export dates used for calculating overall revenue totals.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Recurly MCP Server: 11 Tools for Billing Operations
Use these tools to manage billing accounts, list invoices, query subscriptions, and track revenue data directly from your AI agent.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Recurly on Vinkius019dd149create billing account
Registers a new billing account within Recurly using required user information.
019dd149get account details
Retrieves the current balance, status, and metadata for a specific billing account ID.
019dd149get invoice
Fetches detailed information about one specific invoice by its unique ID.
019dd149get revenue summary
Calculates and retrieves data used for determining overall revenue export dates and summary metrics.
019dd149get subscription details
Retrieves comprehensive details, including plan information and status, for a single subscription ID.
019dd149list billing accounts
Generates an array of all currently managed billing account IDs within your Recurly system.
019dd149list billing invoices
Provides a list of invoices, allowing you to filter and track payments over specific date ranges.
019dd149list coupons
Retrieves a list of all active coupon codes available for use on subscriptions or billing.
019dd149list subscription plans
Queries and lists every available subscription plan and its associated price points in the system.
019dd149list subscriptions
Lists all active and expired subscriptions currently linked to your Recurly account.
019dd149list transactions
Gathers a list of recent financial transactions, providing transaction IDs, dates, and amounts.
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,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ 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
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 11 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Billing inquiries used to take three different tabs and half an hour of cross-referencing.
Today, asking a simple question—like 'What was John Doe's payment status last month?'—means opening the Recurly dashboard, navigating to invoices, finding the right client ID, filtering by date range, and then manually reading the status field. It’s a multi-step process that guarantees human error.
With this MCP server, you ask your agent: 'Check John Doe's invoice payments from last month.' The agent runs `list_billing_invoices` with the correct parameters and returns the exact data point—the payment status—immediately. You get a clean answer, every time.
Recurly MCP Server: Get immediate insights into account health.
Before this server, checking an entire customer segment's revenue meant running complex reports that required manual exports and spreadsheet analysis. You had to build the data view yourself every time you needed a different metric.
Now, calling `get_revenue_summary` provides the core metrics—MRR, growth rates, etc.—directly into your chat context. It moves billing intelligence from 'dashboard' to 'conversation'.
What you can do with this MCP connector
You connect your Recurly account to any AI client and get direct control over billing and subscriptions. This server lets your agent handle complex financial operations using only natural conversation. You don't have to jump through web forms or manually check dashboards; you just ask for what you need, and it pulls the data right into your chat window.
Managing Billing Accounts:
You can start by seeing every billing account you manage across the system using list_billing_accounts. If you know a specific ID, get_account_details lets you pull up the current balance, status, and all the associated metadata for that one account. You'll also need to onboard new clients; your agent registers brand-new billing accounts directly via the create_billing_account tool, requiring only the necessary user information.
Tracking Payments and Invoices:
Checking payment history is simple. Use list_billing_invoices to get a full list of invoices, letting you filter and track payments across specific date ranges. To dig into one transaction, get_invoice fetches all the detailed info for a single invoice using its unique ID. You can also pull a general list of recent financial activity with list_transactions, which gives you the IDs, dates, and dollar amounts for every major movement.
Handling Subscriptions:
For subscription status, your agent pulls everything together. list_subscriptions shows you all active and expired subscriptions linked to your account. When you know a specific ID, get_subscription_details gives you comprehensive info on that single item, including its current plan and detailed status information. You'll also need to see what pricing options are available; list_subscription_plans queries the entire catalog of subscription plans and their associated price points in the system.
Pricing and Coupons:
You can check out every active coupon code by calling list_coupons. This helps you confirm exactly which codes your customers can use on subscriptions or billing. You've got granular control over checking current account status, seeing historical invoice data, listing all plans available for sale, and even registering new users without ever leaving the chat window.
Revenue Reporting:
When it comes to money, you don't have to guess. Use get_revenue_summary to calculate and pull the necessary data points used when exporting overall revenue totals. Everything needed to reconcile your books lives here. This server lets you manage customer accounts, monitor payment statuses, track every plan, and handle all that complicated billing stuff—all through plain language prompts.
019dd149-e103-71cb-bc01-e5a06aec72a2 
How Recurly MCP Works
- 1 Subscribe to the Recurly MCP Server and input your API v3 Key into the server settings.
- 2 Your AI agent calls the appropriate tool (e.g.,
list_billing_invoices) with required parameters (like an invoice ID). - 3 The server executes the call against your live Recurly data and returns a structured JSON object that your agent interprets and presents to you.
The bottom line is, your AI client runs complex billing API calls through simple conversation prompts.
Who Is Recurly MCP For?
This server targets Billing Managers, SaaS Product Leads, and Customer Success Ops staff. If you're tired of switching between the Recurly dashboard, a spreadsheet, and your chat window just to answer 'How much did they pay last month?'—you need this.
Use list_billing_invoices and get_invoice to audit payment failures, check past due dates, and manually verify revenue totals.
Execute get_account_details or list_subscriptions when a client asks about their plan status or billing balance; it’s instant verification for support tickets.
Use list_subscription_plans and get_revenue_summary to validate pricing tiers, understand revenue growth metrics, and confirm product adoption rates.
What Changes When You Connect
- You get real-time visibility into payment failures. Instead of manually sifting through the dashboard, using
list_billing_invoicesallows your agent to tell you exactly which payments failed (e.g., 'Card declined') and how many need follow-up. - Never guess a plan's cost again. Running
list_subscription_plansgives you instant access to all pricing tiers, letting your client confirm the exact price for any given product during conversation. - Account status checks are immediate. Need to know if a customer is active or suspended? Calling
get_account_detailsprovides the balance and current status instantly, without leaving the chat window. - Audit billing history effortlessly. Instead of downloading massive CSV files, you can use
list_transactionsto pull specific data points—like total revenue for last Tuesday—and get a clean summary back. - Onboarding new clients is faster. You don't need to copy-paste forms; using
create_billing_accountlets your agent register the customer account programmatically based on conversational input.
Real-World Use Cases
Auditing a Revenue Gap
The billing manager notices a discrepancy between expected MRR and actual figures. They ask their agent to run list_transactions and cross-reference it with the summary data from get_revenue_summary. The agent identifies that 12 enterprise accounts renewed, but the total revenue figure was miscalculated because they only checked one tool.
Handling a Support Inquiry
A customer asks, 'What's my current plan and balance?' Instead of directing them to a help center article, the agent calls get_account_details and get_subscription_details. The conversation flow is uninterrupted; they get the definitive answer immediately.
Investigating Failed Payments
The finance team needs to know why $18,000 was lost last month. They prompt the agent to use list_billing_invoices for that period. The agent returns a breakdown showing 9 payments failed due to 'Insufficient funds,' allowing the team to target specific outreach.
Setting up New Products
A product manager is validating new pricing structures. They first run list_subscription_plans to see existing options, then use list_coupons to check for promotional codes that might interfere with the new plan rollout.
The Tradeoffs
Treating Billing as a Database Query
Trying to run 'SELECT * FROM billing WHERE status = active' against your agent. You can't just query the server like a database; you need specific operations.
→
You must use dedicated functions. To find all active accounts, call list_billing_accounts. If you only want details on one account, run get_account_details with the specific ID.
Forgetting Payment Context
Asking for a revenue total without filtering by date range. The agent might give you an overwhelming dump of data that doesn't answer your question.
→
Always scope your query. Use list_billing_invoices and specify the start/end dates, or use get_revenue_summary to get a period-specific total.
Confusing Plans with Subscriptions
Assuming that listing all available plans (list_subscription_plans) shows what your customers are actually subscribed to. They are two different things.
→
To see what's active, call list_subscriptions. To see what can be sold, run list_subscription_plans.
When It Fits, When It Doesn't
Use this server if your core job involves tracking money movement: managing recurring billing cycles, auditing invoices, or validating account balances. It's essential when you need to bridge the gap between conversation and financial data.
Don't use it if all you need is a simple list of product names—that's covered by list_subscription_plans. But if you need to know which plan a specific customer has, or how much they owe on an invoice, then the granular tools like get_account_details and list_billing_invoices are necessary. If your workflow is purely internal (e.g., generating reports in a separate BI tool), you might not need this direct API access; but if the data needs to flow directly from conversation into action, this is what you need.
Common Questions About Recurly MCP
How do I check a customer's current balance using Recurly MCP Server? +
Call get_account_details. This tool fetches the precise current balance and status for any specific billing account ID. It tells you exactly what they owe right now.
What is the difference between listing subscriptions and listing plans using Recurly MCP Server? +
list_subscriptions shows what your customers currently have active or expired. list_subscription_plans shows every pricing plan you offer to sell.
Can I list all my invoices for a specific time range with Recurly MCP Server? +
Yes, use list_billing_invoices. You can pass date parameters to filter the results and get a clean list of every invoice that falls within your specified window.
How do I register a new account using the create_billing_account tool? +
The create_billing_account tool requires structured input, typically including contact details and billing information. The agent handles mapping these inputs to successfully provision the account in Recurly.
What specific data points does the `list_coupons` tool provide about active promotions? +
The tool lists all currently active coupons, including their unique coupon ID, expiration date, and discount value. This helps your agent quickly check promotion validity or understand a customer's potential savings before an enrollment.
How do I use the `list_transactions` tool to analyze recent billing activity? +
It retrieves a chronological history of all recent financial movements associated with the account. You can pull specific transaction IDs, amounts, and dates to build detailed reports or audit past payments outside your AI client.
What information does the `get_revenue_summary` tool provide regarding billing cycles? +
This function fetches necessary export data and summary metrics for accurate revenue reporting. It allows your agent to calculate key figures like Monthly Recurring Revenue (MRR) across specific, defined time periods.
If I need to verify a client's current billing status, how do I use `get_account_details`? +
Just pass the specific account ID to get detailed information. The response includes the current balance, payment status, and associated metadata for quick verification. This is key when troubleshooting an invoice issue.
Can I list all my active subscriptions using my AI agent? +
Yes! Use the list_subscriptions tool to retrieve a comprehensive list of all subscriptions registered in your Recurly account.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.