LemonSqueezy MCP Server

Activate a license key for an instance. Does not require an API key — uses the license key itself for auth.

Archive a customer. Sets their status to 'archived'. This is reversible by updating their status back.

Cancel a subscription. The subscription remains active until the end of the current billing period, then expires.

Create a new checkout URL for a product variant. Returns a URL where the customer can complete their purchase. Supports custom pricing, prefilled customer data, and checkout customization.

Create a new customer in a store.

Create a new discount code. Supports percentage or fixed amount discounts with optional duration and usage limits.

Report usage for a metered subscription item. Use 'increment' action to add to the current usage, or 'set' to replace it.

Create a new webhook to receive event notifications. The signing secret is returned only once — save it immediately.

Deactivate a license key instance, revoking that instance's access. Destructive: rate-limited and audited, with the license key masked in the audit entry. Does not require an API key — uses the license key itself for auth.

Permanently delete a discount. This is irreversible.

Permanently delete a webhook. This is irreversible.

Generate a PDF invoice for an order. Returns a download URL for the invoice.

Generate a PDF invoice for a subscription invoice. Returns a download URL.

Get a specific affiliate by ID, including commission rate, status, and earnings.

Get a specific checkout by ID, including URL, expiry, and custom data.

Get a specific customer by ID, including name, email, city, country, MRR, total revenue, and customer portal URL.

Get a specific discount by ID, including code, amount, type, and usage limits.

Get a specific discount redemption by ID, showing when and where a discount was used.

Get a specific file by ID, including name, size, download URL, and associated variant.

Get a specific license key by ID, including key value, status, activation limit, and expiry date.

Get a specific license key instance (activation) by ID, including instance name and creation date.

Get a specific order by ID, including status, total, currency, customer info, and payment details.

Get a specific order item by ID, including product name, variant, price, and quantity.

Get a specific price by ID, including amount, currency, and billing interval. Every record is annotated with `effective_unit_price` (cents actually charged per unit) and `effective_unit_price_note`. READ THAT, not `unit_price`: on a tiered scheme (volume/graduated) `unit_price` is vestigial and is NOT the charged amount -- the real per-unit price lives in `tiers[]`, and such records also carry `unit_price_is_not_charged: true`. On `package` pricing `unit_price` IS charged, but it buys a block of `package_size` units, so `effective_unit_price` reports the per-unit figure and the record carries `unit_price_is_per_package: true`.

Get a specific product by ID, including name, description, price, and status.

Get a specific store by ID, including name, slug, currency, and sales statistics.

Get a specific subscription by ID, including status, billing interval, renewal date, and customer info.

Get a specific subscription invoice by ID, including status, total, billing reason, and payment details.

Get a specific subscription item by ID, including quantity, pricing, and associated subscription. Pass `include=price` for the price record behind it; embedded price records are annotated with `effective_unit_price` (cents actually charged per unit) -- read that, not the record's `unit_price`, which is vestigial on tiered pricing and per-package on package pricing.

Get the current usage for a metered subscription item within the current billing period.

Get a specific usage record by ID, including quantity and action type.

Get the authenticated user's information including name, email, and avatar.

Get a specific product variant by ID, including billing interval and trial settings. WARNING: do NOT read `price` as the amount charged. For usage-based, per-seat or otherwise tiered variants it is vestigial and commonly reads the same value across products that bill very differently. The authoritative per-unit price lives on the variant's PRICE resource -- call ls_list_prices with this variantId, take the newest record by `created_at`, and read its `effective_unit_price`.

Get a specific webhook by ID, including URL, events, and last sent timestamp.

List all affiliates for the authenticated user's stores, optionally filtered by user email. Results are paginated — check meta.page in the response for currentPage, lastPage, and total. Cross-store note: LEMONSQUEEZY_ALLOWED_STORE_IDS does NOT gate this tool -- it has no storeId field and no parent ID filter to scope by, so it returns affiliates tied to every store the API key can see, including non-allowed ones. Pair with a scoped LemonSqueezy API key for true cross-store enforcement -- the API key's visibility is the true boundary.

List all checkouts, optionally filtered by store or variant. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.

List all customers, optionally filtered by store or email. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.

List all discount redemptions, optionally filtered by discount or order. Results are paginated — check meta.page in the response for currentPage, lastPage, and total. Cross-store note: when LEMONSQUEEZY_ALLOWED_STORE_IDS is set, this tool requires at least one of: discountId, orderId. Even with that set, Pair with a scoped LemonSqueezy API key for true cross-store enforcement -- the API key's visibility is the true boundary.

List all discounts, optionally filtered by store. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.

List all files, optionally filtered by variant. Results are paginated — check meta.page in the response for currentPage, lastPage, and total. Cross-store note: when LEMONSQUEEZY_ALLOWED_STORE_IDS is set, this tool requires at least one of: variantId. Even with that set, Pair with a scoped LemonSqueezy API key for true cross-store enforcement -- the API key's visibility is the true boundary.

List all license key instances (activations), optionally filtered by license key. Results are paginated — check meta.page in the response for currentPage, lastPage, and total. Cross-store note: when LEMONSQUEEZY_ALLOWED_STORE_IDS is set, this tool requires at least one of: licenseKeyId. Even with that set, Pair with a scoped LemonSqueezy API key for true cross-store enforcement -- the API key's visibility is the true boundary.

List all license keys, optionally filtered by store, order, or product. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.

List all order items, optionally filtered by order or product. Results are paginated — check meta.page in the response for currentPage, lastPage, and total. Cross-store note: when LEMONSQUEEZY_ALLOWED_STORE_IDS is set, this tool requires at least one of: orderId, productId, variantId. Even with that set, Pair with a scoped LemonSqueezy API key for true cross-store enforcement -- the API key's visibility is the true boundary.

List all orders, optionally filtered by store or user email. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.

List all prices, optionally filtered by variant. Results are paginated — check meta.page in the response for currentPage, lastPage, and total. Every record is annotated with `effective_unit_price` (cents actually charged per unit) and `effective_unit_price_note`. READ THAT, not `unit_price`: on a tiered scheme (volume/graduated) `unit_price` is vestigial and is NOT the charged amount -- the real per-unit price lives in `tiers[]`, and such records also carry `unit_price_is_not_charged: true`. On `package` pricing `unit_price` IS charged, but it buys a block of `package_size` units, so `effective_unit_price` reports the per-unit figure and the record carries `unit_price_is_per_package: true`. NOTE that several price records can exist per variant; the CURRENT one is the newest by `created_at` (results are sorted newest-first). Cross-store note: when LEMONSQUEEZY_ALLOWED_STORE_IDS is set, this tool requires at least one of: variantId. Even with that set, Pair with a scoped LemonSqueezy API key for true cross-store enforcement -- the API key's visibility is the true boundary.

List all products, optionally filtered by store. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.

List all stores for the authenticated user. Results are paginated — check meta.page in the response for currentPage, lastPage, and total. Cross-store note: LEMONSQUEEZY_ALLOWED_STORE_IDS does NOT gate this tool -- it has no storeId field and no parent ID filter to scope by, so it returns every store the API key can see, including stores outside the allowlist. Pair with a scoped LemonSqueezy API key for true cross-store enforcement -- the API key's visibility is the true boundary.

List all subscription invoices, optionally filtered by store, subscription, or status. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.

List all subscription items, optionally filtered by subscription or price. Results are paginated — check meta.page in the response for currentPage, lastPage, and total. Pass `include=price` for the price records behind them; embedded price records are annotated with `effective_unit_price` (cents actually charged per unit) -- read that, not a record's `unit_price`, which is vestigial on tiered pricing and per-package on package pricing. Cross-store note: when LEMONSQUEEZY_ALLOWED_STORE_IDS is set, this tool requires at least one of: subscriptionId, priceId. Even with that set, Pair with a scoped LemonSqueezy API key for true cross-store enforcement -- the API key's visibility is the true boundary.

List all subscriptions, optionally filtered by store, order, product, variant, or status. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.