All servers / Payments / Lemon Squeezy MCP server
Lemon Squeezy MCP server
Lemon Squeezy MCP server: stores, orders, subscriptions, license keys, refunds, and webhooks.
Tested by ConnectATDScore 86 out of 100. Tested 2026-11-19 on package version 1.1.3. Package: @yawlabs/lemonsqueezy-mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 8 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (1.3 seconds including download)
- Tools offered: 64
- Last published: 2026-11-16
- Weekly downloads (npm): 759
- License: MIT · Direct dependencies: 0
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
ls_get_userno parametersGet the authenticated user's information including name, email, and avatar.
ls_get_store2 of 2 parameters describedGet a specific store by ID, including name, slug, currency, and sales statistics.
ls_list_stores3 of 3 parameters describedList 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.
ls_get_customer2 of 2 parameters describedGet a specific customer by ID, including name, email, city, country, MRR, total revenue, and customer portal URL.
ls_list_customers5 of 5 parameters describedList all customers, optionally filtered by store or email. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_create_customer6 of 6 parameters describedCreate a new customer in a store.
ls_update_customer7 of 7 parameters describedUpdate 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.
ls_archive_customer1 of 1 parameter describedArchive a customer. Sets their status to 'archived'. This is reversible by updating their status back.
ls_get_product2 of 2 parameters describedGet a specific product by ID, including name, description, price, and status.
ls_list_products4 of 4 parameters describedList all products, optionally filtered by store. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_get_variant2 of 2 parameters describedGet 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`.
ls_list_variants4 of 4 parameters describedList all variants, optionally filtered by product. Results are paginated — check meta.page in the response for currentPage, lastPage, and total. 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 each variant's PRICE resource: call ls_list_prices with the variantId, take the newest record by `created_at`, and read its `effective_unit_price`. 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.
ls_get_price2 of 2 parameters describedGet 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`.
ls_list_prices4 of 4 parameters describedList 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.
ls_get_file2 of 2 parameters describedGet a specific file by ID, including name, size, download URL, and associated variant.
ls_list_files4 of 4 parameters describedList 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.
ls_get_order2 of 2 parameters describedGet a specific order by ID, including status, total, currency, customer info, and payment details.
ls_list_orders5 of 5 parameters describedList all orders, optionally filtered by store or user email. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_generate_order_invoice9 of 9 parameters describedGenerate a PDF invoice for an order. Returns a download URL for the invoice.
ls_refund_order2 of 2 parameters describedIssue a refund for an order. This is irreversible — the refund amount is in cents (e.g. 1000 = $10.00).
ls_get_order_item2 of 2 parameters describedGet a specific order item by ID, including product name, variant, price, and quantity.
ls_list_order_items6 of 6 parameters describedList 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.
ls_get_subscription2 of 2 parameters describedGet a specific subscription by ID, including status, billing interval, renewal date, and customer info.
ls_list_subscriptions10 of 10 parameters describedList 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.
ls_update_subscription8 of 8 parameters describedUpdate 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 cancellation.
ls_cancel_subscription1 of 1 parameter describedCancel a subscription. The subscription remains active until the end of the current billing period, then expires.
ls_get_subscription_invoice2 of 2 parameters describedGet a specific subscription invoice by ID, including status, total, billing reason, and payment details.
ls_list_subscription_invoices7 of 7 parameters describedList all subscription invoices, optionally filtered by store, subscription, or status. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_generate_subscription_invoice9 of 9 parameters describedGenerate a PDF invoice for a subscription invoice. Returns a download URL.
ls_refund_subscription_invoice2 of 2 parameters describedIssue a refund for a subscription invoice. This is irreversible — the refund amount is in cents (e.g. 1000 = $10.00).
ls_get_subscription_item2 of 2 parameters describedGet 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.
ls_list_subscription_items5 of 5 parameters describedList 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.
ls_update_subscription_item2 of 2 parameters describedUpdate a subscription item's quantity. Used for seat-based or quantity-based billing.
ls_get_subscription_item_usage1 of 1 parameter describedGet the current usage for a metered subscription item within the current billing period.
ls_get_usage_record2 of 2 parameters describedGet a specific usage record by ID, including quantity and action type.
ls_list_usage_records4 of 4 parameters describedList 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.
ls_create_usage_record3 of 3 parameters describedReport usage for a metered subscription item. Use 'increment' action to add to the current usage, or 'set' to replace it.
ls_get_discount2 of 2 parameters describedGet a specific discount by ID, including code, amount, type, and usage limits.
ls_list_discounts4 of 4 parameters describedList all discounts, optionally filtered by store. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_create_discount12 of 12 parameters describedCreate a new discount code. Supports percentage or fixed amount discounts with optional duration and usage limits.
ls_delete_discount1 of 1 parameter describedPermanently delete a discount. This is irreversible.
ls_get_discount_redemption2 of 2 parameters describedGet a specific discount redemption by ID, showing when and where a discount was used.
ls_list_discount_redemptions5 of 5 parameters describedList 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.
ls_get_license_key2 of 2 parameters describedGet a specific license key by ID, including key value, status, activation limit, and expiry date.
ls_list_license_keys7 of 7 parameters describedList all license keys, optionally filtered by store, order, or product. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_update_license_key4 of 4 parameters describedUpdate 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.
ls_get_license_key_instance2 of 2 parameters describedGet a specific license key instance (activation) by ID, including instance name and creation date.
ls_list_license_key_instances4 of 4 parameters describedList 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.
ls_get_checkout2 of 2 parameters describedGet a specific checkout by ID, including URL, expiry, and custom data.
ls_list_checkouts5 of 5 parameters describedList all checkouts, optionally filtered by store or variant. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_create_checkout12 of 12 parameters describedCreate 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.
ls_get_webhook2 of 2 parameters describedGet a specific webhook by ID, including URL, events, and last sent timestamp.
ls_list_webhooks4 of 4 parameters describedList all webhooks, optionally filtered by store. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_create_webhook4 of 4 parameters describedCreate a new webhook to receive event notifications. The signing secret is returned only once — save it immediately.
ls_update_webhook4 of 4 parameters describedUpdate 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).
ls_delete_webhook1 of 1 parameter describedPermanently delete a webhook. This is irreversible.
ls_activate_license2 of 2 parameters describedActivate a license key for an instance. Does not require an API key — uses the license key itself for auth.
ls_validate_license2 of 2 parameters describedValidate a license key or specific instance. Does not require an API key — uses the license key itself for auth.
ls_deactivate_license2 of 2 parameters describedDeactivate 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.
ls_get_affiliate2 of 2 parameters describedGet a specific affiliate by ID, including commission rate, status, and earnings.
ls_list_affiliates4 of 4 parameters describedList 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.
ls_sink_events_list3 of 3 parameters describedList 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.
ls_sink_event_mark_processed1 of 1 parameter describedMark a sink event as processed by your consumer. Idempotent.
ls_sink_statsno parametersGet sink totals: total events, unprocessed count, last-received timestamp.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.