# Recharge MCP > Recharge MCP handles everything related to recurring billing and subscriptions. Use this connector to manage customer profiles, track order history, analyze revenue charges, and modify subscription status entirely through conversation. It’s the fastest way to get deep operational data from your e-commerce billing system without touching a dashboard or running complex scripts. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** subscriptions, recurring-billing, shopify-subscriptions, ecommerce-automation, recharge ## Description Managing recurring revenue is messy. You shouldn't have to jump between the Recharge dashboard, write API calls, and cross-reference billing records just to know if a customer’s payment failed or what their current plan details are. This MCP lets your AI client handle all that complexity using natural language. Need to see every active subscription? Just ask. Want to find out why revenue dropped last month by analyzing charges? Ask the agent to pull that data, and it'll surface the financial insights for you. The goal is simple: let your agent perform complex billing operations—from listing customer addresses to updating a plan quantity—all in one chat window. By connecting this MCP through Vinkius, you get immediate, conversational access to all 11 core tools needed to keep subscription commerce running smoothly. ## Tools ### cancel_subscription Immediately cancels an existing customer's subscription plan. ### get_customer Retrieves full profile details for a specific subscriber ID. ### get_order Pulls the complete details for a single, processed order. ### list_products Gets an inventory list of all subscription products available in your store. ### get_subscription_details Retrieves comprehensive status and metadata for one specific active subscription. ### list_shipping_addresses Lists all shipping addresses tied to a customer profile. ### list_billing_charges Gathers historical data on all processed financial charges. ### list_customers Provides a list of every subscriber currently in the Recharge system. ### list_subscription_orders Retrieves a history of all processed subscription orders. ### list_subscriptions Gives you an overview list of every current and canceled subscription plan. ### update_subscription Changes the parameters, quantity, or scheduled charge date for a live subscription. ## Prompt Examples **Prompt:** ``` List all active subscriptions in Recharge. ``` **Response:** ``` I've retrieved your subscriptions. You have 50 active subscriptions, including 'Premium Coffee Plan' and 'Monthly Supplement Pack'. ``` **Prompt:** ``` Show me all active subscriptions that are due for renewal in the next 7 days. ``` **Response:** ``` 142 subscriptions due for renewal within 7 days. Tomorrow: 23 renewals ($4,567 total). Wednesday: 31 renewals ($6,234). Thursday-Sunday: 88 renewals ($18,900). Top products: "Monthly Coffee Box" (45 renewals), "Protein Pack" (34), "Wellness Bundle" (28). 8 subscriptions have failed payment methods that need updating. 3 customers requested skipping their next delivery. Total projected renewal revenue: $29,701. ``` **Prompt:** ``` Show me the churn analysis for the last 30 days with cancellation reasons. ``` **Response:** ``` 89 cancellations in the last 30 days (4.2% churn rate, down from 5.1% last month). Reasons: "Too expensive" (34%), "No longer needed" (22%), "Switching to competitor" (18%), "Product quality" (12%), "Delivery issues" (8%), "Other" (6%). Average subscription length before cancellation: 4.7 months. Revenue lost: $12,340. 23 cancellations were win-back eligible. 8 customers paused instead of cancelling after retention offers. ``` ## Capabilities ### Analyze and list active subscriptions You can pull a full list of existing plans or retrieve the detailed metadata for any single subscription. ### Manage customer data and addresses Query subscriber profiles, get specific billing information, and list all associated shipping addresses. ### Track payments and order history Get details on specific orders or pull comprehensive lists of processed billing charges to understand revenue flow. ### Update subscription status and quantity Programmatically change the number of items in a plan or modify an existing subscription's parameters without manual dashboard clicks. ### Handle customer lookups and list products Search your database to pull specific customer records or see all available subscription product offerings. ## Use Cases ### Diagnosing revenue drops for finance The billing analyst notices an unexpected dip in projected revenue. They ask the agent to list all billing charges and get a full overview of subscriptions using `list_subscriptions` to pinpoint exactly which product line is underperforming. ### Updating a customer's shipping details The operations manager needs to send an address update for a high-value client. Instead of finding the customer in multiple tabs, they ask the agent to use `get_customer` and then call `list_shipping_addresses` to get the right record. ### Processing bulk account changes The product team launches a new tier that requires changing 50 existing plans. They ask the agent to list all subscriptions, filter for the target group, and then loop through calling `update_subscription` for each one. ### Handling payment failures A customer reports a failed charge. The agent pulls the specific order details using `get_order`, checks the billing charges via `list_billing_charges`, and determines if an update is needed, guiding the user to fix it. ## Benefits - Stop cross-referencing tabs. Instead of manually checking customer records, you can ask the agent to use `get_customer` and instantly pull profiles and mailing addresses into your chat. - Never miss a payment detail again. You can list all billing charges using `list_billing_charges`, giving you immediate visibility into historical revenue streams without running reports. - Manage plans on the fly. If a customer needs more items, use `update_subscription` to modify their plan quantity or change the next charge date—no dashboard clicks needed. - Keep track of everything from sign-up to delivery. You can list all subscription orders (`list_subscription_orders`) and get specific order details using `get_order`, keeping your fulfillment pipeline tight. - Quickly identify service gaps by running a full review with `list_subscriptions` or seeing what products are available via `list_products`. ## How It Works The bottom line is: once connected, your agent handles all the complex back-end calls so you don't have to think about them. 1. Subscribe to the Recharge MCP on Vinkius. 2. Input your API Access Token, which you get from your store's settings. 3. Start chatting with your AI client and ask for billing or customer data using plain language. ## Frequently Asked Questions **How can I check if a customer's payment failed using Recharge MCP?** You can use `get_order` and `list_billing_charges`. The agent pulls the most recent order details and cross-references them with your billing charges to spot discrepancies or failures. **What is the best way to see all products available for subscription?** Use the `list_products` tool. It gives you a complete inventory snapshot of every product that can be sold as a recurring subscription service. **Can I change a customer's plan without using the website dashboard?** Yes, use the `update_subscription` tool. You simply tell your agent which subscription you want to modify and what changes to make—like increasing quantity or changing the date. **What if I need to find out all my customers' names?** The `list_customers` tool provides a comprehensive list of every subscriber currently registered with Recharge, giving you an immediate roster. **Does the MCP help me track where customers are located?** Use `list_shipping_addresses`. This tool retrieves all saved shipping addresses linked to any specific customer profile in your system.