# Loop Subscriptions MCP

> Loop Subscriptions MCP connects your AI agent directly to Shopify's recurring revenue data. Manage every aspect of customer billing cycles—from pausing services to listing all active subscriptions. Your client can track down customer profiles, view order history, cancel accounts with specific reasons, and even skip upcoming deliveries using natural language prompts.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** recurring-revenue, subscription-management, shopify-integration, order-management, customer-lifecycle, churn-reduction

## Description

This MCP lets your agent handle complex subscription tasks right where you need them. You no longer have to jump between Shopify dashboards and spreadsheets just to manage billing cycles. Your agent monitors recurring revenue streams, pulling detailed customer profiles alongside their entire history of subscriptions. Need to adjust a client's service? You can pause an active membership and schedule the restart date for months out. If a customer needs a break, your agent handles canceling the account with a mandatory reason code. For operational visibility, you can easily list every current subscription or view all recent orders. The platform makes tracking the health of your recurring business simple, allowing your client to handle everything from retrieving detailed customer profiles to adjusting service status without leaving your workflow. It's one powerful addition to the entire Vinkius catalog that keeps revenue management centralized.

## Tools

### cancel_subscription
Cancels an active subscription and requires a mandatory reason provided by the user.

### get_customer
Retrieves specific details for a customer based on their identification information.

### get_subscription
Fetches detailed information about one particular subscription ID.

### list_customers
Generates a list of all customers, including those with both active and past subscriptions.

### list_orders
Retrieves a list of subscription-related orders that have been processed or are pending.

### list_subscriptions
Generates a comprehensive list containing all existing Loop Subscriptions for the store.

### pause_subscription
Pauses an active membership, allowing you to optionally set a specific date for when it should restart.

### resume_subscription
Activates a previously paused subscription account back into service.

### skip_next_order
Marks the next scheduled delivery or order for cancellation, preventing it from being fulfilled.

## Prompt Examples

**Prompt:** 
```
List my active subscriptions.
```

**Response:** 
```
Fetching subscriptions... I've found 15 active subscriptions. Here are the most recent ones...
```

**Prompt:** 
```
Pause subscription #12345 until 2026-12-01.
```

**Response:** 
```
Pausing subscription #12345... Success! It is now scheduled to resume on December 1st, 2026.
```

**Prompt:** 
```
Skip the next delivery for customer 'John Doe'.
```

**Response:** 
```
Finding John Doe's subscription... Found! Skipping the next scheduled order as requested.
```

## Capabilities

### List all active and past subscriptions
The agent retrieves a complete roster of every subscription linked to the Shopify store.

### Modify service status (Pause/Resume)
You can instruct your client to pause an ongoing membership, optionally setting a future date for when it should reactivate.

### Cancel customer accounts
Your agent terminates a subscription and requires you to provide a specific reason code for the cancellation record.

### Adjust delivery schedules
If requested, your client can skip the next scheduled order for any given subscriber.

### Gather detailed customer records
Retrieves comprehensive profiles and full subscription history for specific users.

## Use Cases

### A client needs a temporary pause for travel.
Instead of emailing support tickets and waiting days for an update, I tell my agent to `pause_subscription` for the customer's account until my return date. The service is suspended immediately, solving the problem in seconds.

### I need to process bulk changes after a promotion.
After our big sale ended, I asked my agent to `list_subscriptions` and then identify all accounts that should be resumed. It gave me the list, and with one command, it ran `resume_subscription` for everyone.

### A customer suddenly quits or changes services.
I need to make sure we follow procedure. I tell my agent to `cancel_subscription`, providing 'Customer requested change' as the reason, guaranteeing our records are clean and compliant.

### We have a high volume of missed shipments.
During the holiday rush, several orders were flagged for skipping. I used my agent to check `list_orders` against customer requests and then executed `skip_next_order` for all affected accounts at once.

## Benefits

- Saves time by batching actions. Instead of manually navigating to each customer profile, you can use `list_subscriptions` and then have your agent process multiple changes (like pausing or canceling) in a single command.
- Reduces billing errors. If an agent uses `get_subscription`, it provides immediate, detailed status information, ensuring that when you communicate with customers, the data you rely on is accurate and up-to-date.
- Improves customer service flow. When a client calls to cancel, your agent can execute `cancel_subscription` immediately while making sure to capture the required reason code for records.
- Provides operational oversight. Use `list_orders` or `list_customers` to get a quick view of revenue health and identify any accounts that might have missed an order delivery cycle.
- Manages billing pauses easily. If a customer goes on vacation, you can tell your agent to use the `pause_subscription` tool and set the exact resume date, preventing service interruption headaches.

## How It Works

The bottom line is that you get Shopify’s entire billing management system accessible through natural conversation with your AI client.

1. Subscribe to this MCP on Vinkius and enter your Loop Admin API Token.
2. Connect the credentials to your preferred AI client, such as Cursor or Claude.
3. Tell your agent exactly what you need—like 'Pause subscription #12345 until next quarter'—and watch it execute.

## Frequently Asked Questions

**How do I list all my current subscriptions using Loop Subscriptions MCP?**
You call the `list_subscriptions` tool. This generates a comprehensive report of every subscription currently active or inactive in your Shopify store.

**Can I cancel an account and specify why they left? (Loop Subscriptions)**
Yes, you use the `cancel_subscription` tool. Crucially, when running this command, you must provide a mandatory reason code to ensure your records are accurate.

**What is the difference between listing orders and listing subscriptions? (Loop Subscriptions)**
The `list_subscriptions` tool shows the account status itself. The `list_orders` tool pulls up transactional data, showing actual payment or delivery records associated with those accounts.

**If I want to suspend a service for three months, which tool do I use? (Loop Subscriptions)**
You must use the `pause_subscription` tool. This allows you to set an exact resume date, ensuring the account reactivates automatically when needed.

**Does Loop Subscriptions MCP handle billing errors?**
This MCP controls the *status* of service, not the financial processing itself. It ensures your agent can list orders and retrieve customer data to help you identify potential billing discrepancies for human review.