# Lemon Squeezy — MCP server on mcp.ai
> Connect your Lemon Squeezy account and use 32 tools for ecommerce straight from your AI agent. Connect with your own API key. Lemon Squeezy is a platform designed to simplify payments, taxes, and subscriptions for software companies, offering a powerful API and webhooks for seamless integration.

By: mcp.ai · official
Page: https://mcp.ai/lemon_squeezy

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_lemon_squeezy?ms=1787291400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/lemon_squeezy/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/lemon_squeezy/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/lemon_squeezy/skill.md
Postman collection (v2.1): https://mcp.ai/lemon_squeezy/postman.json

## Tools
- lemon_squeezy_create_customer(data: object) — Tool to create a new customer. Use after verifying the store exists and you need to add a customer to it. Example: "Create a customer John Doe with email johndoe@example.com in store 1."
- lemon_squeezy_create_discount(data: object) — Tool to create a new discount code in Lemon Squeezy. Use when you need to create promotional discounts for products or subscriptions. Example: "Create a discount code SUMMER20 with 20% off in store 12
- lemon_squeezy_create_webhook(data: object) — Tool to create a new webhook for receiving event notifications. Use when you need to register a webhook endpoint to receive events like order_created, subscription_created, etc. Specify the webhook UR
- lemon_squeezy_delete_discount(id: string) — Tool to delete a discount by its ID. Use when you need to permanently remove a discount from a store.
- lemon_squeezy_delete_webhook(id: string) — Tool to delete a webhook. Use when you need to remove a registered webhook endpoint.
- lemon_squeezy_list_all_affiliates(sort?: string, store_id?: integer, page_size?: integer, user_email?: string, page_number?: integer) — Tool to list all affiliates. Use when you need to retrieve affiliates with optional filters and pagination.
- lemon_squeezy_list_all_checkouts(store_id?: integer, variant_id?: integer) — Tool to list all checkouts. Use when you need a paginated list of checkouts, optionally filtering by store or variant.
- lemon_squeezy_list_all_customers(email?: string, store_id?: integer, page_size?: integer, page_number?: integer) — Retrieves a paginated list of all customers from your Lemon Squeezy store(s). Returns customer details including email, name, location, revenue metrics (MRR, total revenue), marketing status, and rela
- lemon_squeezy_list_all_discount_redemptions(order_id?: integer, page_size?: integer, discount_id?: integer, page_number?: integer) — Tool to list all discount redemptions. Use when you need a paginated list of discount redemptions, optionally filtering by discount or order.
- lemon_squeezy_list_all_discounts(store_id?: integer, page_size?: integer, page_number?: integer) — Tool to list all discounts. Use when you need a paginated list of discounts after confirming authentication.
- lemon_squeezy_list_all_files(include?: string, page_size?: integer, variant_id?: integer, page_number?: integer) — Retrieves a paginated list of files from Lemon Squeezy. Use this to get digital goods that can be downloaded by customers after purchase. Each file belongs to a variant and includes download URLs (sig
- lemon_squeezy_list_all_license_key_instances(page_size?: integer, page_number?: integer, license_key_id?: integer) — Tool to list all license key instances. Use when you need a paginated list of license key instances, optionally filtering by license key ID.
- lemon_squeezy_list_all_license_keys(include?: string, order_id?: integer, store_id?: integer, page_size?: integer, product_id?: integer, page_number?: integer, order_item_id?: integer) — Tool to list all license keys. Use when you need a paginated list of license keys, optionally filtering by store, order, order item, or product.
- lemon_squeezy_list_all_order_items(page_size?: integer, page_number?: integer, filter_order_id?: string, filter_product_id?: string, filter_variant_id?: string) — Tool to list all order items. Use when you need a paginated list of order items, optionally filtered by order, product, or variant. Note: the `first_order_item` field on an order object returns only o
- lemon_squeezy_list_all_orders(store_id?: integer, page_size?: integer, user_email?: string, page_number?: integer, order_number?: integer) — Tool to list all orders. Use when you need a paginated list of orders, optionally filtering by store or user email. Monetary fields (e.g., `subtotal`, `tax`, `total`) are integers in the smallest curr
- lemon_squeezy_list_all_prices(page_size?: integer, variant_id?: integer, page_number?: integer) — Tool to list all prices. Use when you need a paginated list of all prices, optionally filtering by variant.
- lemon_squeezy_list_all_products(store_id?: integer, page_size?: integer, page_number?: integer) — List all products from your Lemon Squeezy store with pagination and filtering. Returns a paginated list of products ordered by name. Each product includes pricing, status, thumbnails, checkout URLs, a
- lemon_squeezy_list_all_stores(page_size?: integer, page_number?: integer) — Retrieves a paginated list of all stores belonging to the authenticated Lemon Squeezy account. This action returns comprehensive store information including store details (name, slug, domain, URL), fi
- lemon_squeezy_list_all_subscription_invoices(status?: string, refunded?: boolean, store_id?: integer, page_size?: integer, page_number?: integer, subscription_id?: integer) — Tool to list all subscription invoices. Use when you need a paginated list of subscription invoices with optional filters.
- lemon_squeezy_list_all_subscription_items(price_id?: integer, page_size?: integer, page_number?: integer, subscription_id?: integer) — Tool to list all subscription items. Use when you need a paginated list of items across subscriptions for reporting or auditing.
- lemon_squeezy_list_all_subscriptions(status?: string, order_id?: integer, store_id?: integer, page_size?: integer, product_id?: integer, user_email?: string, variant_id?: integer, page_number?: integer, order_item_id?: integer) — Tool to list all subscriptions. Use when you need a paginated list of subscriptions, optionally filtered by store, order, product, or status.
- lemon_squeezy_list_all_usage_records(page_size?: integer, page_number?: integer, subscription_item_id?: integer) — Retrieves all usage records from Lemon Squeezy, with optional filtering and pagination. Usage records track consumption for usage-based billing on subscription items. Each record represents reported u
- lemon_squeezy_list_all_variants(status?: string, page_size?: integer, product_id?: integer, page_number?: integer) — Retrieves a paginated list of product variants from Lemon Squeezy. A variant represents a variation of a product with its own pricing options, files, and license key settings. You can filter by produc
- lemon_squeezy_list_all_webhooks(store_id?: integer, page_size?: integer, page_number?: integer) — Tool to list all webhooks. Use when you need to retrieve registered webhooks. Supports optional filtering by store ID and pagination parameters for controlling result size and navigation.
- lemon_squeezy_retrieve_authenticated_user() — Tool to retrieve the currently authenticated user from Lemon Squeezy. Use when you need to get details about the user associated with the current API key, including their name, email, avatar, and acco
- lemon_squeezy_retrieve_customer(id: string) — Tool to retrieve a specific customer by their ID. Use when you need detailed information about a single customer including their email, name, location, revenue metrics, and relationships to orders and
- lemon_squeezy_retrieve_discount(id: string) — Tool to retrieve a single discount by ID. Use when you need details about a specific discount.
- lemon_squeezy_retrieve_store(id: string) — Tool to retrieve a store by its ID. Use when you need to get detailed information about a specific store. Returns comprehensive store data including financial metrics, configuration, and related resou
- lemon_squeezy_retrieve_webhook(id: string) — Tool to retrieve a webhook by its ID. Use when you need to get details of a specific webhook configuration.
- lemon_squeezy_update_customer(id: string, city?: string, name?: string, email?: string, region?: string, country?: string) — Tool to update an existing customer with the given ID. Use when you need to modify customer details like name, email, or address information. At least one attribute field must be provided to update.
- lemon_squeezy_update_webhook(data: object) — Tool to update an existing webhook. Use when you need to modify the URL, events, or secret for a registered webhook.
- lemon_squeezy_validate_license(instance_id?: string, license_key: string) — Tool to validate a license key and optionally a specific license key instance. Use when you need to check if a license key is valid and active.

## Example prompts
- "What can I do in Lemon Squeezy?"
- "Show me a summary of my Lemon Squeezy account"

## Links
Docs: https://mcp.ai/docs/mcps/lemon_squeezy
Website: https://mcp.ai/mcps/lemon_squeezy