# Lemon Squeezy MCP for AI Agents AI Agent Connect

> Lemon Squeezy MCP lets you manage your digital sales, subscriptions, and customer data through your AI agent. It connects your store to your workspace so you can check orders, list products, and monitor MRR without leaving your chat window. It's built for anyone selling software or digital goods who needs to keep an eye on the numbers without constant tab switching.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_TqHz7mqL4qxjY36OJP8fXcQCSxZPUrp73XeUvaal/ai-agent-connect
- **Tags:** saas-billing, merchant-of-record, tax-compliance, subscription-management, digital-products, order-tracking

## Description

This Connector connects your Lemon Squeezy store to your AI client so you can manage your digital sales through a simple chat interface. Instead of constantly switching tabs to check your dashboard, you can ask your agent to pull specific data like your current MRR, refund rates, or customer purchase history. It handles the heavy lifting of interacting with your store's API, allowing you to monitor active subscriptions and list products without leaving your workspace. You can quickly see which promo codes are performing best or grab the details of a specific order when a customer reaches out with a question. By integrating this into your workflow via Vinkius, you get a direct line to your revenue data. It turns your store's backend into a searchable database for your agent, whether you're an indie dev tracking a new launch or a SaaS founder monitoring churn. You no longer have to manually hunt for transaction IDs or scroll through endless lists of subscribers to find a specific account. The data is always there, ready for your agent to summarize or analyze on command. Whether you are looking for a quick revenue pulse check or a deep dive into your customer's lifetime value, this connection puts the power of your store's backend into a conversational format.

## Tools

### get_subscription
Fetch the specific details for a single recurring subscription. This helps you check renewal dates and pricing.

### list_customers
Pull a complete list of every customer in your database. You can use this to see who has made purchases.

### list_discounts
View all active promo codes and their current usage stats. This is great for tracking flash sale performance.

### list_orders
Get a full history of all sales and transactions. Use this to find specific order IDs or amounts.

### list_products
Retrieve a list of every product you sell. This shows you your entire catalog and pricing tiers.

### list_stores
See all the different store profiles linked to your account. Use this to manage multiple storefronts.

### list_subscriptions
Get a list of every active and past subscription. This is the quickest way to check your recurring revenue.

### list_variants
View the different versions and price points for your products. This helps you see your full offering.

### list_webhooks
Check which automated triggers are currently configured. This is useful for debugging your store's integrations.

### get_account_info
Pull the high level profile and settings for your store. Use this to get a quick overview of your account.

### get_order
Fetch the specific details for one individual transaction. This is perfect for troubleshooting a single customer's payment.

### get_product
Get the full description and data for a specific item. Use this to double check your product listings.

## Prompt Examples

**Prompt:** 
```
What's our MRR right now and how many new subs did we get this week?
```

**Response:** 
```
### Subscription Summary
- **Monthly Recurring Revenue (MRR):** $12,400
- **New Subscriptions (This Week):** +18
- **Active Subscribers:** 279

**Breakdown by Plan:**
| Plan | Active Subs | Monthly Revenue |
| :--- | :--- | :--- |
| Team Plan | 234 | $6,786 |
| Enterprise | 45 | $4,455 |

*Growth looks steady with a low churn rate of 2.1%.*
```

**Prompt:** 
```
Show me the top 5 customers who spent the most money.
```

**Response:** 
```
### Top Customers by Lifetime Value (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)
4. **GlobalRetail** — $950 (Team, 3 seats, 8 months)
5. **DesignHub** — $820 (Starter, 6 months)

*Total customer count: 1,890.*
```

**Prompt:** 
```
Are there any active discount codes we can use for a flash sale?
```

**Response:** 
```
### Active Promo Codes
There are currently **3** active discount codes:
- **LAUNCH20**: 20% off (Used 45 times)
- **ANNUAL30**: 30% off annual plans (Used 12 times)
- **PARTNER50**: 50% off for partners only (Used 3 times)

*Would you like me to check the usage limits on any of these?*
```

## Capabilities

### Check active subscriptions
See your current recurring revenue and active subscriber count in one go.

### Pull customer purchase history
Look up specific user data and see what they've bought from your store.

### View product variants
See all different pricing tiers and versions for your products.

### Monitor discount codes
Track how often your promo codes are being used and which ones are active.

### Retrieve store orders
Get a full history of every transaction and sales record.

### Get store account info
Pull high level profile details and settings for your store account.

## Use Cases

### Checking MRR for a SaaS launch
A founder wants to know the revenue from a new launch. They ask the agent to list_subscriptions and calculate the total MRR for the week.

### Troubleshooting a failed payment
A customer says they weren't charged. The dev uses get_order to find the transaction and see if it went through.

### Auditing promo code usage
A creator wants to see if a 20% off code worked. They use list_discounts to check how many times it was used.

### Finding high-value customers
A support lead needs to see the spend of a VIP. They use list_customers to find the user and see their history.

## Benefits

- Stop switching tabs to check your revenue by using list_subscriptions to get real-time MRR data directly in your chat.
- Identify your highest-value users quickly with list_customers to see their full purchase history and LTV.
- Check your active promo codes instantly with list_discounts to see which ones are actually being used.
- Troubleshoot customer issues faster by using get_order to pull specific transaction details in seconds.
- Manage your entire catalog at once with list_products to see every item and price point you offer.
- Monitor your subscription health with get_subscription to see renewal dates and status without a dashboard.

## How It Works

The bottom line is you get a direct line to your sales data without ever opening a separate browser tab.

1. Subscribe to the Lemon Squeezy MCP on Vinkius.
2. Paste your Lemon Squeezy API Key into the configuration.
3. Ask your agent to list your top-selling products or check recent orders.

## Frequently Asked Questions

**Can I use Lemon Squeezy MCP to check my monthly revenue?**
Yes, you can ask your agent to pull your recurring revenue and see how your subscriptions are performing. It gives you a clear picture of your growth without any manual math.

**How do I see my customer list with Lemon Squeezy MCP?**
The Connector lets your agent pull a full list of your customers. You can then ask questions about their purchase history or total spend.

**Can I use Lemon Squeezy MCP in Cursor or Claude?**
Yes, this Connector works with any compatible client like Claude, Cursor, or Windsurf. Once connected, your agent can access your store data directly.

**Can I see my active promo codes using Lemon Squeezy MCP?**
You can. Your agent can pull a list of all your active discounts so you can see which ones are being used and how often.

**Is it safe to connect my Lemon Squeezy store to an Connector?**
Yes, the Connector uses your API key to securely fetch data. You stay in control of what your agent can see and do within your store.

**How does Lemon Squeezy MCP help with SaaS billing?**
It makes it easy to monitor your subscriptions and orders. You can check for churn, see your MRR, and find specific order details in seconds.

**Can I track subscriptions and MRR?**
Yes. Monitor active subscriptions, renewals, cancellations, churn rate, and MRR with growth trends.

**Can I manage products and discount codes?**
Yes. List products with variants and pricing. Access discount codes, checkout links, and store settings.

**What API does Lemon Squeezy use?**
Bearer authentication against `api.lemonsqueezy.com/v1`. JSON:API format.