LemonSqueezy MCP Server

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 …

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.

Description is built at runtime.

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.

Description is built at runtime.

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

Description is built at runtime.

Description is built at runtime.

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.

Description is built at runtime.

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

Description is built at runtime.

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

Description is built at runtime.

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.

Description is built at runtime.

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.

Description is built at runtime.

Description is built at runtime.

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

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

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

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

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.

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

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.

Update a license key's activation limit, expiry date, or disabled status. Setting `disabled: true`, changing `activationLimit`, or changing `expiresAt` can revoke customer access and is treated as destructive (rate-limited and audited); `disabled: false` alone is not.

Update a subscription. Can change the variant (plan switch), pause/unpause, set billing anchor, or update invoice details. Pausing (`pause: 'void'` or `'free'`), switching plan (`variantId`), changing the billing anchor (`billingAnchor`), invoicing immediately (`invoiceImmediately: true`), or changing the trial end (`trialEndsAt`) changes what the customer pays or when, and is treated as destructive (rate-limited and audited); resuming (`pause: 'resume'`), un-cancelling (`cancelled: false`), `invoiceImmediately: false` and `disableProrations` are not. Use ls_cancel_subscription for cancellatio…

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

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).

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