# Lemon Squeezy MCP

> Lemon Squeezy MCP connects your AI client directly to your entire digital storefront backend. It lets you manage everything from product catalogs and customer profiles to complex billing cycles and order history—all through natural conversation. Automate tasks like checking renewal dates, listing all sales channels, or canceling specific subscriptions without ever opening the Lemon Squeezy dashboard.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** digital-products, subscription-management, merchant-services, order-processing, saas-billing

## Description

Use this MCP to give your AI client full operational access to your e-commerce backend. You can manage products, track orders, and handle customer accounts using nothing but plain language. Your agent gets read/write access to list all stores, query product pricing details, or pull up an order’s financial total, giving you deep visibility into your sales process without manual clicks. This capability is built on the JSON:API standard, making it reliable for any compatible client. Vinkius hosts this connection so you can simply plug in your preferred AI agent and start managing complex subscription lifecycles or running reports just by asking a question. It’s about treating your e-commerce data like anything else—a source of truth that an agent can query instantly.

## Tools

### cancel_subscription
Cancels an active subscription, ensuring the customer keeps access until the billing cycle ends.

### list_all_customers
Retrieves a list of every customer associated with your Lemon Squeezy account.

### get_customer_details
Fetches specific profile and activity details for one particular customer by their ID.

### get_order_details
Retrieves the full financial and itemized breakdown for a single, specified order.

### get_product_details
Gets detailed information about one specific product, including its pricing and status.

### get_store_details
Retrieves all configuration details for a single sales store you manage.

### get_subscription_details
Pulls the current status, renewal date, and plan type for one specific subscription.

### list_all_orders
Generates a complete list of all customer orders recorded in your account history.

### list_all_products
Lists every available product and service configured within your Lemon Squeezy account.

### list_stores
Provides a comprehensive list of all the stores linked to your Lemon Squeezy profile.

### list_all_subscriptions
Lists both active and past subscriptions, giving an overview of your billing history.

## Prompt Examples

**Prompt:** 
```
List all products in my Lemon Squeezy account.
```

**Response:** 
```
I've retrieved your products. You have 5 products, including 'SaaS Pro Plan ($49.00)', 'E-book: Mastering AI ($19.00)', and 3 others. Would you like to see the purchase URLs for any of them?
```

**Prompt:** 
```
Show my 5 most recent orders.
```

**Response:** 
```
I found 5 recent orders. Notable ones include Order #12345 from 'John Smith' ($49.00) and Order #12344 from 'Alice Doe' ($19.00). Both are currently marked as 'paid'.
```

**Prompt:** 
```
Get details for subscription ID '98765'.
```

**Response:** 
```
I've fetched the details for subscription 98765. The status is 'active', and the next renewal is scheduled for July 15th. The associated customer is 'jane@example.com'.
```

## Capabilities

### Inventory and Store Oversight
Retrieve detailed information, including configuration metadata, for all linked stores.

### Product Catalog Querying
List your entire product catalog, retrieving key data like pricing structures and direct purchase links.

### Order History Retrieval
Pull up comprehensive details for specific customer orders, including payment status and financial breakdowns.

### Subscription Management
Monitor active or historical subscriptions; you can retrieve renewal dates or cancel plans directly through the agent.

### Customer Data Lookup
Access full customer records, allowing you to view their entire purchase and subscription history in one place.

## Use Cases

### Investigating Failed Orders
A manager needs to find out why Order #901 failed payment. They ask their agent, which uses `get_order_details` to return the payment status and financial breakdown immediately, letting them know if it was a card issue or an inventory problem.

### Onboarding New Team Members
A new team member needs to see what products are currently sellable. They ask their agent to run `list_all_products`, which provides a clean, structured list of all available items and their current purchase URLs.

### Handling Account Deactivation
An admin needs to process an account cancellation for a former client. They ask the agent to `cancel_subscription` using the customer ID, confirming that access remains until the end of the billing cycle without needing manual intervention.

### Quarterly Business Review Prep
The founder needs an overview of all sales activity. They ask their agent to run `list_all_orders` and then follow up with a request for active accounts using `list_all_subscriptions`, compiling the data into one conversation thread.

## Benefits

- Stop jumping between tabs to check status. Need to know if a subscription is active or when it renews? Just ask your agent, and the `get_subscription_details` tool gives you the answer instantly.
- Audit sales performance without opening the dashboard. You can easily run reports by asking for all orders using `list_all_orders`, getting payment totals and dates in a clean summary.
- Handle customer issues on the fly. If someone calls about their purchase, your agent uses `get_customer_details` to pull up their history—no copy-pasting needed.
- Manage product updates from chat. Instead of navigating deep into settings, you can use `list_all_products` and `get_product_details` to quickly check pricing or status for marketing material.
- Simplify complex billing tasks. To stop a customer's recurring charges, your agent executes the `cancel_subscription` tool, handling the full lifecycle management process in one step.

## How It Works

The bottom line is that you treat complex e-commerce backend tasks like simple chat queries instead of clicking through multiple dashboards.

1. Subscribe to this MCP on Vinkius and provide your Lemon Squeezy API key.
2. Connect the MCP credentials to your preferred AI client (like Cursor or Claude).
3. Ask your agent a plain language question, such as 'Show me all active subscriptions for John Doe's account.' The agent executes the necessary tool calls and returns structured data.

## Frequently Asked Questions

**Can I use Lemon Squeezy MCP to list all my products?**
Yes. You can run `list_all_products` using your agent to get a comprehensive catalog of every product and service you sell in the account.

**How do I check if an order was paid for using Lemon Squeezy MCP?**
You use the `get_order_details` tool. By providing the specific order ID, your agent retrieves the full financial breakdown and confirms the payment status.

**Does Lemon Squeezy MCP let me cancel a subscription?**
Yes. The dedicated `cancel_subscription` tool allows you to initiate cancellations directly through your AI agent, ensuring the customer retains access until their current billing cycle ends.

**What if I only know the customer's email? Can Lemon Squeezy MCP help?**
Yes. You can first use `get_customer_details` with the customer's identifying information to pull up their profile and complete purchase history.

**Can I see all my sales channels in Lemon Squeezy MCP?**
You can start by using `list_stores`. This tool retrieves a list of every store configured in your account, giving you oversight of all sales endpoints.