# Recurly MCP for AI Agents AI Agent Connect > Recurly MCP lets your AI agent handle subscription billing, account management, and invoice tracking without you having to leave your workspace. It gives your agent the ability to create accounts, modify subscription states, and pull historical billing data instantly. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_g0qdRL48L0h7QcG6agZzwEbKWDJDpwwNbcpQHMwB/ai-agent-connect - **Tags:** subscriptions, billing, recurring-revenue, saas-billing, revenue-management, recurly ## Description Stop jumping back and forth between your billing dashboard and your team's communication tools. This Connector connects your subscription billing platform to your AI agent so you can handle revenue operations through a simple chat interface. Instead of manually digging through a console to find a customer's missing invoice or checking if a subscription is still active, you just ask your agent to do it. It gives your AI the same permissions you have, but it executes them much faster. Whether you're helping a customer who wants to reactivate their plan or checking the status of a high-value account, the agent handles the heavy lifting of navigating the API. This is a win for anyone trying to keep revenue operations clean or for support teams who are tired of escalating every billing question to a specialist. It's one of the many ways Vinkius helps you turn static data into actionable actions by letting your agent actually move the needle on your business operations. You handle the high-volume stuff, like account creation and plan adjustments, without ever having to leave your workspace. It also lets developers test their own provisioning logic by interacting directly with the catalog plans and subscription states. ## Tools ### get_subscription_details Get the full status and details for a specific subscription. Use this to check current billing cycles and plan types. ### get_invoice Get details for a specific invoice ### get_revenue_summary Get revenue export dates ### list_coupons List all active coupons ### list_transactions List recent transactions ### create_billing_account Register a new account ### get_account_details Look up specific billing and profile details for a single customer. This provides a full snapshot of an account's history. ### list_billing_invoices List invoices ### list_subscription_plans List available plans ### list_subscriptions See every subscription managed by your Recurly instance at once. Use this to get a high-level view of your active billing. ### list_billing_accounts List billing accounts ## Prompt Examples **Prompt:** ``` Does customer 'alpha_92' have any unpaid invoices? ``` **Response:** ``` I checked the billing records for account **alpha_92** (Alpha Corp). | Invoice ID | Amount | Status | | :--- | :--- | :--- | | IN_UUID_1012 | $59.00 | Paid | | IN_UUID_1013 | $199.00 | **Pending** | It looks like the most recent invoice is still outstanding. ``` **Prompt:** ``` Cancel the subscription for 'sub_39xjd82kw0' right now. ``` **Response:** ``` Done. I've processed the cancellation for subscription **sub_39xjd82kw0**. * **Status:** Canceled * **Note:** This action is irreversible. The subscription will not renew at the end of the current cycle. ``` **Prompt:** ``` What plans are we currently selling in our catalog? ``` **Response:** ``` Here are the active plans in your product catalog: * **Basic Tier** - $19/mo * **Pro Tier** - $49/mo * **Enterprise Tier** - Custom Pricing Would you like me to enroll a user in one of these? ``` ## Capabilities ### Create new customer accounts Your agent can set up new customer profiles using names, emails, and unique codes. ### Modify active subscription states The agent can instantly pause, reactivate, or cancel ongoing billing mandates. ### Retrieve historical invoice data You can pull a full list of generated invoices to verify past payments. ### List all available product plans Your agent can see every plan in your catalog to help with user enrollment. ### Look up specific account billing details Get a full snapshot of a customer's current status and billing history. ## Use Cases ### Instant subscription cancellation A customer wants to stop paying. The agent uses cancel_subscription to end the mandate immediately during the chat. ### Automated MRR reporting A RevOps manager asks for a list of all active plans. The agent uses list_subscriptions to pull the data for a report. ### Rapid user onboarding A new lead signs up. The agent uses create_account and create_subscription to get them started on a paid plan. ### Billing discrepancy check A customer claims they paid. The agent uses list_invoices to find the specific transaction and verify the status. ## Benefits - Faster Support: Use reactivate_subscription to help customers get back online instantly without creating a manual ticket. - Accurate Audits: Use list_invoices to quickly verify payment history during financial reviews or disputes. - Faster Onboarding: Use create_account and create_subscription to set up new users in seconds rather than minutes. - Real-time Status: Use get_account_details to see current billing states without ever opening the Recurly dashboard. - Plan Management: Use list_catalog_plans to keep your AI updated on what products you actually offer to customers. ## How It Works The bottom line is you get a direct line of communication between your AI and your billing engine. 1. Add the Recurly MCP to your authorized module list in your AI client. 2. Configure the connection using your subdomain and Private API Key. 3. Ask your agent to perform tasks like cancelling a subscription or listing invoices. ## Frequently Asked Questions **Can the Recurly MCP help my support team handle cancellations?** Yes. Your agents can use the Connector to cancel or reactivate subscriptions instantly during a chat, saving your team from manual dashboard work. **How does the Recurly MCP speed up my revenue operations?** It allows your AI to pull invoice history and account details on demand, so you can get answers to billing questions in seconds. **Can I use the Recurly MCP to create new customer accounts?** Yes. You can have your agent create new accounts with specific names and emails, which speeds up your user onboarding flow. **Does the Recurly MCP work with my existing billing data?** Yes, it connects directly to your Recurly instance to interact with your real-time subscription data and catalog plans. **Can the Recurly MCP reactivate a customer's subscription?** Yes, it can turn back on subscriptions that were previously canceled or expired, making it easy to win back former customers. **Is the Recurly MCP good for checking invoice statuses?** It's perfect for that. Your agent can list all generated invoices to verify if a payment was successful or is still pending. **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. **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.