# Lemon Squeezy MCP

> Lemon Squeezy MCP connects your digital storefront to any AI client, giving you full control over sales data. Manage global tax compliance, track complex subscriptions, monitor monthly recurring revenue (MRR), and process all order details for software and digital product sales.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** saas-billing, merchant-of-record, tax-compliance, subscription-management, digital-products, order-tracking

## Description

This MCP lets your agent handle the entire lifecycle of selling digital goods. Instead of logging into a dashboard to check numbers, you simply ask your AI client to pull specific reports—like total MRR or customers who haven't renewed yet. It manages everything from initial purchases to complex billing cycles, ensuring tax rules are handled correctly for sales worldwide. You can use it to list products with variants and pricing details, track every order status, and monitor active subscriptions without leaving your conversational flow. When you connect this MCP via Vinkius, you gain a single point of access to all your revenue data, letting you focus on building software instead of reconciling spreadsheets.

## Tools

### get_account_info
Retrieves general information about your connected merchant account profile.

### get_order
Pulls complete details for a single customer order, including line items and payment status.

### get_product
Fetches detailed information about one specific digital product listing.

### get_subscription
Retrieves comprehensive details regarding a single customer's subscription plan and billing cycle.

### list_customers
Generates a list of all paying customers, detailing their purchase history and overall value.

### list_discounts
Lists available promotional codes and shows how many times each code has been used.

### list_orders
Provides a summary list of all completed transactions, allowing filtering by date range or status.

### list_products
Lists every digital product sold through the store and provides basic sales metrics for each.

### list_stores
Retrieves a list of all associated storefronts or market locations connected to the account.

### list_subscriptions
Gets an overview of every active and lapsed subscription, which is useful for tracking overall user base size.

### list_variants
Lists all specific product variations (like 'Basic' or 'Pro') attached to a main digital product listing.

### list_webhooks
Displays the currently configured webhooks, useful for auditing integration points.

## Prompt Examples

**Prompt:** 
```
Show all products with sales data and this month's revenue.
```

**Response:** 
```
Products: 4. 'Pro License' ($49/one-time, 890 sales, $43.6K). 'Team Plan' ($29/mo, 234 active subs). 'Enterprise' ($99/mo, 45 active). 'Starter Kit' ($19, 1.2K sales, $22.8K). This month: $12,400 revenue. MRR: $8,850. One-time: $3,550. Orders: 68. Refunds: 2 ($98).
```

**Prompt:** 
```
Show active subscriptions and churn analysis.
```

**Response:** 
```
Active subscriptions: 279. Team Plan: 234 ($6,786/mo). Enterprise: 45 ($4,455/mo). MRR: $11,241. This month: +18 new, -6 cancelled. Churn: 2.1% (excellent). Net revenue retention: 108%. Upcoming renewals (7 days): 32. At-risk (payment failed): 3.
```

**Prompt:** 
```
List customers sorted by LTV and show discount codes.
```

**Response:** 
```
Top customers by LTV: 1) Acme Corp — $2,376 (Enterprise, 24 months). 2) TechCo — $1,740 (Team, 5 seats, 12 months). 3) StartupXYZ — $1,188 (Enterprise, 12 months). Total customers: 1,890. Discount codes: 3 active. 'LAUNCH20' (20% off, 45 uses). 'ANNUAL30' (30% annual, 12 uses). 'PARTNER50' (50%, partner only, 3 uses).
```

## Capabilities

### Audit account details
Retrieve basic information about the connected merchant profile.

### Process individual orders
Get full details on a specific transaction, including items purchased and payment status.

### Check product inventory data
Fetch comprehensive information about any digital product listing, including variations and pricing tiers.

### Analyze subscription status
Review specific active or lapsed subscription records to understand customer retention.

### Manage customer lists
Pull a complete list of all paying customers, along with their purchase history and lifetime value data.

### View promotional codes
List and check the status of available discount or promo codes for your store.

## Use Cases

### Identifying revenue gaps after a promotion
A founder needs to know if a recent discount was effective. They ask their agent to cross-reference the `list_orders` data with the details from `get_product` to calculate the true revenue impact versus expected sales.

### Handling a large customer onboarding wave
An operations manager needs to verify that all new users are correctly billed. They ask the agent to run `list_customers` and then use `get_subscription` on a few IDs to confirm billing status.

### Auditing store setup before launch
A developer needs to ensure all selling points are covered. They check `list_products` for completeness, run `get_account_info` to verify settings, and then use `list_variants` to confirm pricing tiers.

### Forecasting quarterly billing cycles
The finance team needs a total picture of recurring income. They ask the agent to run `list_subscriptions` and analyze the data to estimate next quarter's expected revenue flow.

## Benefits

- Track revenue trends instantly. Instead of running complex reports, you can ask the agent to pull summary data across all products and subscriptions in one query.
- Maintain compliance globally. The MCP handles tax calculation logic, ensuring your reporting reflects necessary regional adjustments for digital sales.
- Analyze customer value easily. Use `list_customers` to quickly identify top-tier users by Lifetime Value (LTV) without manual database queries.
- Monitor retention health. You can get specific subscription details and list all active subscriptions to gauge current MRR and forecast upcoming renewals.
- Manage sales promotions on the fly. Check which discount codes are live and how many times they've been used using `list_discounts` before a launch event.

## How It Works

The bottom line is that you get a natural language interface over complex financial APIs, making data querying as easy as asking a teammate for a report.

1. Subscribe to this MCP and provide your Lemon Squeezy API key.
2. Your AI client authenticates the connection, granting access to all defined sales tools.
3. You ask your agent questions like 'What was last month's MRR?' and it executes the necessary calls to pull structured data.

## Frequently Asked Questions

**How do I check sales tax compliance using Lemon Squeezy MCP?**
The system automatically handles global tax rules during data retrieval. You don't need to manually calculate it; simply ask for a revenue report and the necessary taxes will be included.

**Can I get current pricing information with list_variants?**
Yes, `list_variants` shows all available variations for a product, including their specific pricing tiers. This is useful when auditing which prices are active on your storefronts.

**What data does the get_order tool provide?**
The `get_order` tool pulls comprehensive transaction details. You'll get information about who placed the order, what was purchased, and the final payment status for that specific sale.

**Does Lemon Squeezy MCP track churn rates?**
You can monitor retention by using `list_subscriptions` to count active accounts and cross-referencing this with `get_subscription` details to see renewal patterns, giving you a solid basis for churn analysis.

**How do I list all my products and their sales performance?**
Use `list_products`. This tool provides an overview of every digital product available and gives basic sales metrics right in the summary, so you know which items are performing best.