# Lemon Squeezy MCP > Lemon Squeezy (Merchant of Record & Payments) handles payments and subscription management for your SaaS business using natural conversation. Manage product catalogs, create customers, track usage records, and process invoices directly through your AI client without switching tabs. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** merchant-of-record, saas-billing, customer-management, store-management, payment-gateway ## Description Connect your Lemon Squeezy account to any AI agent and manage your entire Merchant of Record workflow right from your chat interface. You can treat your AI like a dedicated billing assistant that never sleeps; it handles everything from listing all active stores to checking if a customer's payment method is valid. For instance, instead of logging into the Lemon Squeezy dashboard just to find an order ID, you ask your agent and get the details instantly. You can also automate core processes like generating invoices or updating customer records with simple prompts. This MCP makes it easy for any compatible client, including those in the Vinkius catalog, to handle complex tasks that used to require jumping between five different browser tabs. ## Tools ### activate_license Activates a specific license key so the user can start using the product. ### cancel_subscription Cancels an active subscription for a customer. ### create_checkout Initializes a new payment checkout process for a user or product. ### create_customer Adds a brand-new customer record to the system. ### create_discount Generates and saves a new discount code or promotion for use. ### create_usage_record Logs specific usage data against an account for billing purposes. ### create_webhook Sets up a new webhook endpoint to notify external services of events. ### deactivate_license Deactivates an existing license key, revoking access. ### delete_discount Permanently deletes a previously created discount code. ### delete_webhook Removes a webhook endpoint from the system. ### generate_order_invoice Creates an invoice document for a completed order. ### generate_subscription_invoice Generates an invoice specifically for recurring subscription charges. ### get_affiliate Retrieves the profile details of a specific affiliate partner. ### get_checkout Fetches the details and status of an existing checkout session. ### get_customer Retrieves all key data points for a specific customer, like contact info or order history. ### get_discount_redemption Retrieves details about when and how a specific discount was used. ### get_discount Fetches the rules and status of a particular discount code. ### get_file Downloads or retrieves a specific file associated with the store. ### get_license_key_instance Gets details about how a specific license key was deployed or used. ### get_license_key Retrieves the unique identifier for a purchased license key. ### get_me Identifies and retrieves the profile of the currently logged-in user making the request. ### get_order_item Retrieves the specifics of one item within an order. ### get_order Fetches all details for a specific completed order, including items and totals. ### get_price Gets the current monetary value or pricing structure for a product or service. ### get_product Retrieves all information about a specific digital or physical product sold in the store. ### get_store Fetches details for one of your active merchant storefronts. ### get_subscription_invoice Gets a copy or details of an invoice generated for a recurring subscription charge. ### get_subscription_item_current_usage Checks how much of an item's allotted usage capacity a customer has consumed this period. ### get_subscription_item Retrieves the specifics and billing cycle details for one item within a subscription. ### get_subscription Retrieves the status and billing cycle information for a user's subscription plan. ### get_usage_record Retrieves detailed data showing when and how much a resource was used for billing. ### get_variant Gets the specific details (like color or size) of a product variant. ### get_webhook Retrieves all configuration settings for an existing webhook endpoint. ### list_affiliates Lists all affiliate partners connected to the store, along with their details. ### list_checkouts Retrieves a list of all recent or pending checkout sessions. ### list_customers Lists multiple customers, allowing filtering by email or store ID. ### list_discount_redemptions Provides a list of all times that discount codes were successfully used. ### list_discounts Lists every available or expired discount code currently in the system. ### list_files Retrieves a list of all files uploaded to the store's asset library. ### list_license_key_instances Lists every deployed or used instance of a license key across different accounts. ### list_license_keys Provides an overview list of all purchased and available license keys. ### list_order_items Lists every product item included in a specific order. ### list_orders Retrieves a paginated list of all historical and recent orders. ### list_prices Lists every price point or pricing tier defined in the store. ### list_products Provides a comprehensive listing of all products offered by the merchant. ### list_stores Lists every individual storefront or business hub connected to your account. ### list_subscription_invoices Retrieves a list of all generated invoices for subscriptions over time. ### list_subscription_items Lists every distinct subscription item (e.g., 'Pro Plan' or 'Extra Storage') available. ### list_subscriptions Retrieves a list of all current and past customer subscriptions. ### list_usage_records Provides an overall overview of usage records across the entire system. ### list_variants Lists all product variants (e.g., Small/Blue) available for purchase. ### list_webhooks Retrieves a list of all active webhook endpoints configured in the store. ### refund_order Initiates a full or partial refund for an order using its ID. ### refund_subscription_invoice Issues a refund specifically against a subscription invoice record. ### update_customer Modifies specific customer data, like email or billing address. ### update_license_key Changes the status or associated details of a license key. ### update_subscription_item Updates the specifics or billing rules for a single item within a subscription. ### update_subscription Modifies the core parameters (like plan type) of an active subscription. ### update_webhook Changes the URL or payload structure of an existing webhook endpoint. ### validate_license Confirms that a provided license key is active and valid for use. ## Prompt Examples **Prompt:** ``` List all my Lemon Squeezy stores. ``` **Response:** ``` I've retrieved your stores. You have one active store: 'My Digital Shop' (ID: 45678). Would you like to see the products or customers for this store? ``` **Prompt:** ``` Create a new customer named Alice Smith with email alice@example.com for store 45678. ``` **Response:** ``` Processing... Alice Smith has been successfully created as a customer in store 45678 with ID 987654. ``` **Prompt:** ``` Get the details for product ID 12345. ``` **Response:** ``` Fetching product data... Product 'SaaS Pro Plan' (ID: 12345) is active. It is priced at $49.00 and currently has 152 active subscribers. ``` ## Capabilities ### Manage Product Inventory Retrieve detailed information or list all products and stores across your entire Lemon Squeezy account. ### Process Customer Data Changes Create new customer accounts, update existing profiles, or retrieve specific billing details for any user. ### Control Subscriptions and Payments Cancel subscriptions, validate license keys, generate invoices, or issue refunds against orders and subscription billing. ### Audit Usage and Discounts Access detailed usage records, list all active discounts, or retrieve specific discount redemption details for compliance checks. ### Maintain Webhooks and Integrations Manage the technical plumbing of your store by listing, creating, updating, or deleting webhooks. ## Use Cases ### Handling Onboarding and Payments A new user signs up. Instead of manually guiding them through the checkout pages, they ask their agent to create a new customer record using `create_customer` and initiate the payment flow with `create_checkout`. The process is completed in three conversational steps. ### Billing Dispute Resolution A customer complains about an overcharge. You ask your agent to retrieve the specific subscription invoice using `get_subscription_invoice` and review the usage record via `get_usage_record`. This provides immediate, verifiable proof for resolution. ### Running Quarterly Financial Audits The ops lead needs to know all promotional activity. They ask the agent to list all discount redemptions using `list_discount_redemptions` and cross-reference that against a full list of orders via `list_orders`. ### Product Updates and Inventory Checks The product manager needs to know if they can sell an item. They ask the agent for details on a specific product using `get_product`, which immediately confirms its active status, pricing (`get_price`), and current inventory. ## Benefits - Stop context switching. Instead of jumping to the Lemon Squeezy dashboard to list all orders or check customer details, you ask your agent directly. It gives you the data instantly. - Handle payments without leaving your workflow. You can generate an invoice for a specific order using `generate_order_invoice` and get the result right in your chat window. - Keep track of usage precisely. If you need to audit resource consumption, your agent retrieves detailed records via tools like `get_usage_record`, making compliance checks simple. - Update customer data on the fly. Need to change an email or update a subscription? You just ask for it; the MCP handles the call using `update_customer` and `update_subscription`. - Simplify refunds. Whether you need to refund an entire order (`refund_order`) or just adjust a recurring billing cycle, you have dedicated tools to handle it. ## How It Works The bottom line is you get one chat window that acts as your entire billing and operations console for Lemon Squeezy. 1. First, you subscribe to this MCP and provide your Lemon Squeezy API Key. 2. Next, your AI agent uses the key to make authenticated calls to the Lemon Squeezy backend. 3. Finally, it presents you with the structured data or confirmation that the requested action (like creating a customer) was completed. ## Frequently Asked Questions **How does the Lemon Squeezy (Merchant of Record & Payments) MCP handle refunds?** It handles refunds via specific tools like `refund_order` or `refund_subscription_invoice`. You tell your agent which order or invoice needs adjusting, and it executes the refund action for you. **Can I use get_customer with Lemon Squeezy (Merchant of Record & Payments) MCP?** Yes. `get_customer` lets you retrieve all key data points for a specific customer, like their contact info or full order history, which is crucial for support. **What's the difference between list_orders and get_order?** `list_orders` gives you an overview—a paginated list of all orders. `get_order`, though, fetches every single detail item for one specific order ID. **How do I manage discounts using the Lemon Squeezy (Merchant of Record & Payments) MCP?** You can list available promotions with `list_discounts` or retrieve details on how a discount was used by calling `get_discount_redemption`. This is key for auditing. **Can I create webhooks using Lemon Squeezy (Merchant of Record & Payments) MCP?** Yes, you can use tools like `create_webhook` to set up new endpoints, or `list_webhooks` to review existing ones. This manages your system's integrations. **How does using `validate_license` help me check if a key is active?** It instantly verifies the status of any provided license key. This tool checks against your account records, telling your agent right away whether the key is currently valid, expired, or already deactivated. **What's the process for setting up a new payment using `create_checkout`?** Using this MCP starts the billing workflow. The `create_checkout` tool generates a secure URL and sets up all required purchase parameters, like product IDs and quantities, before you send it to your customer. **Can I list my products and see their pricing details using `list_products`?** Yes, the tool lists every product in your catalog. It returns essential data points like names, IDs, and current associated pricing information, letting you monitor inventory status across all your stores. **Can I check my own account details and authentication status?** Yes! Use the `get_me` tool to retrieve information about the currently authenticated Lemon Squeezy user profile. **How do I find a specific customer by their email address?** You can use the `list_customers` tool and provide the `filter_email` parameter. The agent will return matching customer records from your store. **Is it possible to update a customer's information like their name or location?** Yes. The `update_customer` tool allows you to modify attributes such as name, email, city, region, and country for an existing customer ID.