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

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

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.

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

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

Create a new customer in a store.

Update an existing customer's name, email, city, region, country, or status. The only supported status value is 'archived'; setting it here is the same operation as ls_archive_customer and is treated as destructive (rate-limited and audited). Other field edits are not.

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

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

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

Get a specific product variant by ID, including price, billing interval, and trial settings.

List all variants, optionally filtered by 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: productId. 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.

Get a specific price by ID, including amount, currency, and billing interval.

List all prices, 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.

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

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.

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

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

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

Issue a refund for an order. This is irreversible — the refund amount is in cents (e.g. 1000 = $10.00).

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

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.

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

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.

Update a subscription. Can change the variant (plan switch), pause/unpause, set billing anchor, or update invoice details. Pausing (pause: 'void' or 'free') or switching plan (variantId) is customer-impacting and is treated as destructive (rate-limited and audited); resuming and the billing-neutral edits are not. Use ls_cancel_subscription for cancellation.

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

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

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.

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

Issue a refund for a subscription invoice. This is irreversible — the refund amount is in cents (e.g. 1000 = $10.00).

Get a specific subscription item by ID, including quantity, pricing, and associated subscription.

List all subscription items, optionally filtered by subscription or price. 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: 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.

Update a subscription item's quantity. Used for seat-based or quantity-based billing.

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.

List all usage records, optionally filtered by subscription item. 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: subscriptionItemId. 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.

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

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

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

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

Permanently delete a discount. This is irreversible.

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

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.

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

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.

Update a license key's activation limit, expiry date, or disabled status. Setting disabled: true revokes customer access and is treated as destructive (rate-limited and audited).

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

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.

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

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

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.

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

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

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

Update an existing webhook's URL, events, or secret. Setting secret rotates the signing secret and breaks signature verification on the receiver until they update their copy -- this is treated as destructive (rate-limited and audited).

Permanently delete a webhook. This is irreversible.

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

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

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

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

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 webhook events the sink has received, optionally filtered. Use since (received_at timestamp, exclusive) to checkpoint. Requires the sink at LEMONSQUEEZY_SINK_URL with LEMONSQUEEZY_SINK_ADMIN_TOKEN.

Mark a sink event as processed by your consumer. Idempotent.

Get sink totals: total events, unprocessed count, last-received timestamp.