{"report":{"v":1,"package":"@yawlabs/lemonsqueezy-mcp","version":"1.1.3","ranAt":"2026-11-16T11:52:01.224Z","install":{"ok":true,"integrity":"sha512-FhxbivS6HPo7wJbUUNPcm4sWykQibwzbWgGws68qYAAFZ2E/IA4zlgBkJC3drG8U/6pL0vzdZKI2CZG5SKAVEg==","deps":0,"scripts":[],"bins":["lemonsqueezy-mcp"],"license":"MIT","engines":"node >=22","repository":"git+https://github.com/YawLabs/lemonsqueezy-mcp.git","bin":"lemonsqueezy-mcp"},"start":{"ok":true,"ms":106,"serverName":"@yawlabs/lemonsqueezy-mcp","serverVersion":"1.1.3","protocol":"2025-06-18"},"tools":[{"name":"ls_get_user","description":"Get the authenticated user's information including name, email, and avatar.","params":[]},{"name":"ls_get_store","description":"Get a specific store by ID, including name, slug, currency, and sales statistics.","params":["storeId","include"]},{"name":"ls_list_stores","description":"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.","params":["include","pageNumber","pageSize"]},{"name":"ls_get_customer","description":"Get a specific customer by ID, including name, email, city, country, MRR, total revenue, and customer portal URL.","params":["customerId","include"]},{"name":"ls_list_customers","description":"List all customers, optionally filtered by store or email. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.","params":["storeId","email","include","pageNumber","pageSize"]},{"name":"ls_create_customer","description":"Create a new customer in a store.","params":["storeId","name","email","city","region","country"]},{"name":"ls_update_customer","description":"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.","params":["customerId","name","email","city","region","country","status"]},{"name":"ls_archive_customer","description":"Archive a customer. Sets their status to 'archived'. This is reversible by updating their status back.","params":["customerId"]},{"name":"ls_get_product","description":"Get a specific product by ID, including name, description, price, and status.","params":["productId","include"]},{"name":"ls_list_products","description":"List all products, optionally filtered by store. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.","params":["storeId","include","pageNumber","pageSize"]},{"name":"ls_get_variant","description":"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`.","params":["variantId","include"]},{"name":"ls_list_variants","description":"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.","params":["productId","include","pageNumber","pageSize"]},{"name":"ls_get_price","description":"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`.","params":["priceId","include"]},{"name":"ls_list_prices","description":"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.","params":["variantId","include","pageNumber","pageSize"]},{"name":"ls_get_file","description":"Get a specific file by ID, including name, size, download URL, and associated variant.","params":["fileId","include"]},{"name":"ls_list_files","description":"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.","params":["variantId","include","pageNumber","pageSize"]},{"name":"ls_get_order","description":"Get a specific order by ID, including status, total, currency, customer info, and payment details.","params":["orderId","include"]},{"name":"ls_list_orders","description":"List all orders, optionally filtered by store or user email. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.","params":["storeId","userEmail","include","pageNumber","pageSize"]},{"name":"ls_generate_order_invoice","description":"Generate a PDF invoice for an order. Returns a download URL for the invoice.","params":["orderId","name","address","city","state","zipCode","country","notes","locale"]},{"name":"ls_refund_order","description":"Issue a refund for an order. This is irreversible — the refund amount is in cents (e.g. 1000 = $10.00).","params":["orderId","amount"]},{"name":"ls_get_order_item","description":"Get a specific order item by ID, including product name, variant, price, and quantity.","params":["orderItemId","include"]},{"name":"ls_list_order_items","description":"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.","params":["orderId","productId","variantId","include","pageNumber","pageSize"]},{"name":"ls_get_subscription","description":"Get a specific subscription by ID, including status, billing interval, renewal date, and customer info.","params":["subscriptionId","include"]},{"name":"ls_list_subscriptions","description":"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.","params":["storeId","orderId","orderItemId","productId","variantId","userEmail","status","include","pageNumber","pageSize"]},{"name":"ls_update_subscription","description":"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.","params":["subscriptionId","variantId","pause","cancelled","billingAnchor","invoiceImmediately","disableProrations","trialEndsAt"]},{"name":"ls_cancel_subscription","description":"Cancel a subscription. The subscription remains active until the end of the current billing period, then expires.","params":["subscriptionId"]},{"name":"ls_get_subscription_invoice","description":"Get a specific subscription invoice by ID, including status, total, billing reason, and payment details.","params":["subscriptionInvoiceId","include"]},{"name":"ls_list_subscription_invoices","description":"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.","params":["storeId","subscriptionId","status","refunded","include","pageNumber","pageSize"]},{"name":"ls_generate_subscription_invoice","description":"Generate a PDF invoice for a subscription invoice. Returns a download URL.","params":["subscriptionInvoiceId","name","address","city","state","zipCode","country","notes","locale"]},{"name":"ls_refund_subscription_invoice","description":"Issue a refund for a subscription invoice. This is irreversible — the refund amount is in cents (e.g. 1000 = $10.00).","params":["subscriptionInvoiceId","amount"]},{"name":"ls_get_subscription_item","description":"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.","params":["subscriptionItemId","include"]},{"name":"ls_list_subscription_items","description":"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.","params":["subscriptionId","priceId","include","pageNumber","pageSize"]},{"name":"ls_update_subscription_item","description":"Update a subscription item's quantity. Used for seat-based or quantity-based billing.","params":["subscriptionItemId","quantity"]},{"name":"ls_get_subscription_item_usage","description":"Get the current usage for a metered subscription item within the current billing period.","params":["subscriptionItemId"]},{"name":"ls_get_usage_record","description":"Get a specific usage record by ID, including quantity and action type.","params":["usageRecordId","include"]},{"name":"ls_list_usage_records","description":"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.","params":["subscriptionItemId","include","pageNumber","pageSize"]},{"name":"ls_create_usage_record","description":"Report usage for a metered subscription item. Use 'increment' action to add to the current usage, or 'set' to replace it.","params":["subscriptionItemId","quantity","action"]},{"name":"ls_get_discount","description":"Get a specific discount by ID, including code, amount, type, and usage limits.","params":["discountId","include"]},{"name":"ls_list_discounts","description":"List all discounts, optionally filtered by store. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.","params":["storeId","include","pageNumber","pageSize"]},{"name":"ls_create_discount","description":"Create a new discount code. Supports percentage or fixed amount discounts with optional duration and usage limits.","params":["storeId","name","code","amount","amountType","duration","durationInMonths","maxRedemptions","startsAt","expiresAt","isLimitedToProducts","variantIds"]},{"name":"ls_delete_discount","description":"Permanently delete a discount. This is irreversible.","params":["discountId"]},{"name":"ls_get_discount_redemption","description":"Get a specific discount redemption by ID, showing when and where a discount was used.","params":["discountRedemptionId","include"]},{"name":"ls_list_discount_redemptions","description":"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.","params":["discountId","orderId","include","pageNumber","pageSize"]},{"name":"ls_get_license_key","description":"Get a specific license key by ID, including key value, status, activation limit, and expiry date.","params":["licenseKeyId","include"]},{"name":"ls_list_license_keys","description":"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.","params":["storeId","orderId","orderItemId","productId","include","pageNumber","pageSize"]},{"name":"ls_update_license_key","description":"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.","params":["licenseKeyId","activationLimit","disabled","expiresAt"]},{"name":"ls_get_license_key_instance","description":"Get a specific license key instance (activation) by ID, including instance name and creation date.","params":["licenseKeyInstanceId","include"]},{"name":"ls_list_license_key_instances","description":"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.","params":["licenseKeyId","include","pageNumber","pageSize"]},{"name":"ls_get_checkout","description":"Get a specific checkout by ID, including URL, expiry, and custom data.","params":["checkoutId","include"]},{"name":"ls_list_checkouts","description":"List all checkouts, optionally filtered by store or variant. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.","params":["storeId","variantId","include","pageNumber","pageSize"]},{"name":"ls_create_checkout","description":"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.","params":["storeId","variantId","customPrice","enabledVariants","email","name","billingAddressCountry","billingAddressZip","taxNumber","discountCode","customData","expiresAt"]},{"name":"ls_get_webhook","description":"Get a specific webhook by ID, including URL, events, and last sent timestamp.","params":["webhookId","include"]},{"name":"ls_list_webhooks","description":"List all webhooks, optionally filtered by store. Results are paginated — check meta.page in the response for currentPage, lastPage, and total.","params":["storeId","include","pageNumber","pageSize"]},{"name":"ls_create_webhook","description":"Create a new webhook to receive event notifications. The signing secret is returned only once — save it immediately.","params":["storeId","url","events","secret"]},{"name":"ls_update_webhook","description":"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).","params":["webhookId","url","events","secret"]},{"name":"ls_delete_webhook","description":"Permanently delete a webhook. This is irreversible.","params":["webhookId"]},{"name":"ls_activate_license","description":"Activate a license key for an instance. Does not require an API key — uses the license key itself for auth.","params":["licenseKey","instanceName"]},{"name":"ls_validate_license","description":"Validate a license key or specific instance. Does not require an API key — uses the license key itself for auth.","params":["licenseKey","instanceId"]},{"name":"ls_deactivate_license","description":"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.","params":["licenseKey","instanceId"]},{"name":"ls_get_affiliate","description":"Get a specific affiliate by ID, including commission rate, status, and earnings.","params":["affiliateId","include"]},{"name":"ls_list_affiliates","description":"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.","params":["userEmail","include","pageNumber","pageSize"]},{"name":"ls_sink_events_list","description":"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.","params":["since","type","limit"]},{"name":"ls_sink_event_mark_processed","description":"Mark a sink event as processed by your consumer. Idempotent.","params":["id"]},{"name":"ls_sink_stats","description":"Get sink totals: total events, unprocessed count, last-received timestamp.","params":[]}],"toolsHash":"0e73bdbad2ac6f3227e45951bb4a27970c91724281734c31edf542b4c91dd775","wrote":[],"callsAt":"2026-11-16T11:52:05.318Z","calls":[{"tool":"ls_get_user","ok":false,"ms":4,"bytes":0,"error":"tool reported an error: Error: LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_API_KEY_COMMAND environment variable is required."},{"tool":"ls_list_customers","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: Error: LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_API_KEY_COMMAND environment variable is required."},{"tool":"ls_list_products","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: Error: LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_API_KEY_COMMAND environment variable is required."},{"tool":"ls_list_variants","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: Error: LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_API_KEY_COMMAND environment variable is required."},{"tool":"ls_list_prices","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: Error: LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_API_KEY_COMMAND environment variable is required."}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":64,"wrote":0,"callsTried":5,"callsAnswered":0,"callContacts":[]},"history":[{"package":"@yawlabs/lemonsqueezy-mcp","version":"1.1.3","ranAt":"2026-11-16T11:52:01.224Z","outcome":"started","tools":64,"contacts":0,"flags":0,"serious":0,"toolsHash":"0e73bdbad2ac6f3227e45951bb4a27970c91724281734c31edf542b4c91dd775"},{"package":"@yawlabs/lemonsqueezy-mcp","version":"1.1.2","ranAt":"2026-11-12T18:07:37.019Z","outcome":"started","tools":64,"contacts":0,"flags":0,"serious":0,"toolsHash":"0e73bdbad2ac6f3227e45951bb4a27970c91724281734c31edf542b4c91dd775"}],"page":"https://bragproof.smaverk.com/r/%40yawlabs/lemonsqueezy-mcp"}