# Ordergroove MCP

> Ordergroove MCP manages your recurring revenue cycle directly through your AI client. This connector gives agents the ability to read customer data, check product availability, and manage subscriptions from start to finish. Need to cancel a user's service or update billing details? You can do it programmatically without leaving your chat window. It centralizes all subscription management functions for any e-commerce business model.

## Overview
- **Category:** customer-relationship-management
- **Price:** Free
- **Tags:** recurring-billing, customer-loyalty, subscription-lifecycle, product-catalog, retention-automation

## Description

Managing recurring revenue used to mean jumping between the billing platform, the CRM, and the product catalog—a tedious mess of logins and copy/pasting. Now, you can let your AI agent handle that entire lifecycle. This MCP connects your preferred AI client directly to Ordergroove's core functions. Your agent accesses detailed customer profiles, tracks which products are available for recurring orders, and maintains a complete history of every subscription. You don't just get data; you gain control over the full billing cycle. Whether it’s changing a product frequency or reactivating an account after dormancy, your AI agent handles the commands in plain language. Since Vinkius manages this catalog, connecting your client to Ordergroove means all your critical revenue operations are available in one place.

## Tools

### cancel_subscription
Cancels a specified subscription, requiring you to state why the cancellation is happening.

### get_customer
Retrieves full details about a single customer by identifying them.

### get_product
Fetches all necessary information for one specific product listing.

### get_subscription
Looks up the complete details of a single subscription record using its ID.

### list_customers
Retrieves a list of all customers associated with your Ordergroove account.

### list_products
Gets a comprehensive list of every product available in the catalog.

### list_subscriptions
Lists all subscriptions, allowing you to filter by customer ID or current status (active, paused, etc.).

### reactivate_subscription
Turns back on a subscription that was previously canceled or suspended.

### update_subscription
Modifies core details of an existing subscription, such as frequency or quantity.

## Prompt Examples

**Prompt:** 
```
List active subscriptions for customer 'cust_123'.
```

**Response:** 
```
Fetching subscriptions... I've found 2 active recurring orders for this customer.
```

**Prompt:** 
```
Cancel subscription #sub_abc because the customer requested a refund.
```

**Response:** 
```
Processing cancellation... Success! Subscription #sub_abc is now cancelled with reason: 'Refund Requested'.
```

## Capabilities

### Manage Customer Records
Retrieve detailed customer profiles or list groups of customers for review.

### View Subscription Status
List all active, past, or paused subscriptions, filtering by a specific customer ID or status type.

### Control Billing Lifecycle
Cancel, update, reactivate, or modify the details of any recurring subscription.

### Check Product Inventory and Details
Look up specific product information or list all available products to ensure recurring orders are viable.

## Use Cases

### Customer Retention After Service Lapse
A customer calls because their service stopped. The agent prompts the MCP to run `get_customer`, confirms account details, and then uses `list_subscriptions` to find the specific plan ID. Finally, they use `reactivate_subscription` and confirm the change with the customer.

### Handling Bulk Account Audits
The billing team needs a list of all paused services for an audit. The agent calls `list_subscriptions`, filtering by 'paused' status, giving the team a clean manifest without manual dashboard exports.

### Correcting Billing Errors Mid-Cycle
An employee realizes a customer's product quantity was wrong on their plan. They use `get_subscription` to confirm the ID and then call `update_subscription`, specifying the new desired quantity, instantly fixing the billing record.

### New Product Launch Validation
Before marketing a new offering, an operations lead uses `list_products` to check against existing catalog entries. They then use `get_product` on the proposed item to validate required fields and pricing structures.

## Benefits

- Stop revenue leakage by instantly canceling any subscription. Use the `cancel_subscription` tool to terminate service when a customer leaves, ensuring proper record-keeping.
- Deepen customer relationships using agent access to detailed records. The `get_customer` tool pulls all necessary profiles so your team can speak directly to the user's history.
- Handle complex billing changes with precision. Instead of multiple forms, use `update_subscription` to modify quantities or change frequencies in a single command.
- Speed up onboarding and support by verifying service status immediately. The `list_subscriptions` tool lets you quickly see every recurring order for any customer.
- Maintain product consistency across billing cycles. Use the `get_product` tool before setting up new services to ensure pricing and details are correct.
- Automate recovery workflows easily. If a user account goes dormant, your agent can use `reactivate_subscription` immediately upon confirmation.

## How It Works

The bottom line is, you tell your AI what needs to happen with a customer's billing, and it makes it happen across the system.

1. First, subscribe to the Ordergroove MCP on Vinkius and enter your API Key credentials.
2. Next, prompt your AI client with a natural language request, like 'Cancel subscription X because of Y reason.'
3. Your agent translates that command into the necessary tool calls, executes them against Ordergroove, and returns the resulting status update.

## Frequently Asked Questions

**Can I list all subscriptions with Ordergroove MCP?**
Yes, you can use `list_subscriptions`. This tool lets you filter the results by specific customer IDs or current statuses (like active or suspended) so you only see what you need.

**How do I cancel a subscription using Ordergroove MCP?**
You use the `cancel_subscription` tool. Be sure to include a specific reason for the cancellation when prompting your agent, as that information is required by the system.

**Does Ordergroove MCP let me check product availability?**
Yes. Use the `list_products` and `get_product` tools to get detailed information about every item in your catalog, helping you confirm if a recurring order is viable.

**Can I update a customer's plan details with Ordergroove MCP?**
Yes, the `update_subscription` tool modifies existing plans. You can change quantities or adjust frequencies for active services in one command.

**What if I need to find information on a specific customer?**
Use the `get_customer` tool and provide the necessary ID. This returns all associated details, allowing your agent to understand the full context of their account immediately.