@yawlabs/lemonsqueezy-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 0 of 5 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y @yawlabs/lemonsqueezy-mcp@1.1.3
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
5 tools that take no input and look read-only were called once with nothing. 0 returned a result.
ls_get_user | No usable answer tool reported an error: Error: LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_API_KEY_COMMAND environment variable is required. |
ls_list_customers | No usable answer tool reported an error: Error: LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_API_KEY_COMMAND environment variable is required. |
ls_list_products | No usable answer tool reported an error: Error: LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_API_KEY_COMMAND environment variable is required. |
ls_list_variants | No usable answer tool reported an error: Error: LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_API_KEY_COMMAND environment variable is required. |
ls_list_prices | No usable answer tool reported an error: Error: LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_API_KEY_COMMAND environment variable is required. |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
ls_get_user
Get the authenticated user's information including name, email, and avatar.
ls_get_store storeId, include
Get a specific store by ID, including name, slug, currency, and sales statistics.
ls_list_stores include, pageNumber, pageSize
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.
ls_get_customer customerId, include
Get a specific customer by ID, including name, email, city, country, MRR, total revenue, and customer portal URL.
ls_list_customers storeId, email, include, pageNumber, pageSize
List all customers, optionally filtered by store or email. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
59 more tools
ls_create_customer storeId, name, email, city, region, country
Create a new customer in a store.
ls_update_customer customerId, name, email, city, region, country, status
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.
ls_archive_customer customerId
Archive a customer. Sets their status to 'archived'. This is reversible by updating their status back.
ls_get_product productId, include
Get a specific product by ID, including name, description, price, and status.
ls_list_products storeId, include, pageNumber, pageSize
List all products, optionally filtered by store. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_get_variant variantId, include
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`.
ls_list_variants productId, include, pageNumber, pageSize
List 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_price priceId, include
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`.
ls_list_prices variantId, include, pageNumber, pageSize
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.
ls_get_file fileId, include
Get a specific file by ID, including name, size, download URL, and associated variant.
ls_list_files variantId, include, pageNumber, pageSize
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.
ls_get_order orderId, include
Get a specific order by ID, including status, total, currency, customer info, and payment details.
ls_list_orders storeId, userEmail, include, pageNumber, pageSize
List 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_invoice orderId, name, address, city, state, zipCode, country, notes, locale
Generate a PDF invoice for an order. Returns a download URL for the invoice.
ls_refund_order orderId, amount
Issue a refund for an order. This is irreversible — the refund amount is in cents (e.g. 1000 = $10.00).
ls_get_order_item orderItemId, include
Get a specific order item by ID, including product name, variant, price, and quantity.
ls_list_order_items orderId, productId, variantId, include, pageNumber, pageSize
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.
ls_get_subscription subscriptionId, include
Get a specific subscription by ID, including status, billing interval, renewal date, and customer info.
ls_list_subscriptions storeId, orderId, orderItemId, productId, variantId, userEmail, status, include, pageNumber, pageSize
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.
ls_update_subscription subscriptionId, variantId, pause, cancelled, billingAnchor, invoiceImmediately, disableProrations, trialEndsAt
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 cancellation.
ls_cancel_subscription subscriptionId
Cancel a subscription. The subscription remains active until the end of the current billing period, then expires.
ls_get_subscription_invoice subscriptionInvoiceId, include
Get a specific subscription invoice by ID, including status, total, billing reason, and payment details.
ls_list_subscription_invoices storeId, subscriptionId, status, refunded, include, pageNumber, pageSize
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.
ls_generate_subscription_invoice subscriptionInvoiceId, name, address, city, state, zipCode, country, notes, locale
Generate a PDF invoice for a subscription invoice. Returns a download URL.
ls_refund_subscription_invoice subscriptionInvoiceId, amount
Issue a refund for a subscription invoice. This is irreversible — the refund amount is in cents (e.g. 1000 = $10.00).
ls_get_subscription_item subscriptionItemId, include
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.
ls_list_subscription_items subscriptionId, priceId, include, pageNumber, pageSize
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.
ls_update_subscription_item subscriptionItemId, quantity
Update a subscription item's quantity. Used for seat-based or quantity-based billing.
ls_get_subscription_item_usage subscriptionItemId
Get the current usage for a metered subscription item within the current billing period.
ls_get_usage_record usageRecordId, include
Get a specific usage record by ID, including quantity and action type.
ls_list_usage_records subscriptionItemId, include, pageNumber, pageSize
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.
ls_create_usage_record subscriptionItemId, quantity, action
Report usage for a metered subscription item. Use 'increment' action to add to the current usage, or 'set' to replace it.
ls_get_discount discountId, include
Get a specific discount by ID, including code, amount, type, and usage limits.
ls_list_discounts storeId, include, pageNumber, pageSize
List all discounts, optionally filtered by store. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_create_discount storeId, name, code, amount, amountType, duration, durationInMonths, maxRedemptions, startsAt, expiresAt, isLimitedToProducts, variantIds
Create a new discount code. Supports percentage or fixed amount discounts with optional duration and usage limits.
ls_delete_discount discountId
Permanently delete a discount. This is irreversible.
ls_get_discount_redemption discountRedemptionId, include
Get a specific discount redemption by ID, showing when and where a discount was used.
ls_list_discount_redemptions discountId, orderId, include, pageNumber, pageSize
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.
ls_get_license_key licenseKeyId, include
Get a specific license key by ID, including key value, status, activation limit, and expiry date.
ls_list_license_keys storeId, orderId, orderItemId, productId, include, pageNumber, pageSize
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.
ls_update_license_key licenseKeyId, activationLimit, disabled, expiresAt
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.
ls_get_license_key_instance licenseKeyInstanceId, include
Get a specific license key instance (activation) by ID, including instance name and creation date.
ls_list_license_key_instances licenseKeyId, include, pageNumber, pageSize
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.
ls_get_checkout checkoutId, include
Get a specific checkout by ID, including URL, expiry, and custom data.
ls_list_checkouts storeId, variantId, include, pageNumber, pageSize
List all checkouts, optionally filtered by store or variant. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_create_checkout storeId, variantId, customPrice, enabledVariants, email, name, billingAddressCountry, billingAddressZip, taxNumber, discountCode, customData, expiresAt
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.
ls_get_webhook webhookId, include
Get a specific webhook by ID, including URL, events, and last sent timestamp.
ls_list_webhooks storeId, include, pageNumber, pageSize
List all webhooks, optionally filtered by store. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.
ls_create_webhook storeId, url, events, secret
Create a new webhook to receive event notifications. The signing secret is returned only once — save it immediately.
ls_update_webhook webhookId, url, events, secret
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).
ls_delete_webhook webhookId
Permanently delete a webhook. This is irreversible.
ls_activate_license licenseKey, instanceName
Activate a license key for an instance. Does not require an API key — uses the license key itself for auth.
ls_validate_license licenseKey, instanceId
Validate a license key or specific instance. Does not require an API key — uses the license key itself for auth.
ls_deactivate_license licenseKey, instanceId
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.
ls_get_affiliate affiliateId, include
Get a specific affiliate by ID, including commission rate, status, and earnings.
ls_list_affiliates userEmail, include, pageNumber, pageSize
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.
ls_sink_events_list since, type, limit
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.
ls_sink_event_mark_processed id
Mark a sink event as processed by your consumer. Idempotent.
ls_sink_stats
Get sink totals: total events, unprocessed count, last-received timestamp.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=22 |
| Source | github.com/YawLabs/lemonsqueezy-mcp |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-FhxbivS6HPo7wJbUUNPcm4sWykQibwzbWgGws68qYAAFZ2E/IA4zlgBkJC3drG8U/6pL0vzdZKI2CZG5SKAVEg== |
Versions reported
| Version | Run | Result | Tools |
|---|---|---|---|
| 1.1.3 | 2026-11-16 | Starts with no setup | 64 |
| 1.1.2 | 2026-11-12 | Starts with no setup | 64 |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40yawlabs/lemonsqueezy-mcp)
New version out? Ask for a fresh report.