# Lemon Squeezy MCP for AI Agents AI Agent Connect > Lemon Squeezy MCP lets you manage your store, products, and customers directly through your AI client. You can handle payments, subscriptions, and license keys using natural conversation. It removes the need to jump between browser tabs to find customer IDs or check product statuses, letting you run your SaaS business from a single chat interface. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Pc4cEPaLBWF3m8U7kmJt19wGpCnvKNP8g7NYj581/ai-agent-connect - **Tags:** merchant-of-record, saas-billing, customer-management, store-management, payment-gateway ## Description Managing a Merchant of Record can feel like a chore when you are constantly jumping between tabs to find a specific order ID or to update a customer's billing details. This Connector changes that by letting your AI client do the heavy lifting for you. Instead of hunting through menus, you just tell your agent what needs to happen. You can pull up customer lists, create new products, or issue refunds while you are already in your dev environment or support chat. Because Vinkius makes it so easy to connect these types of tools, you can turn your AI into a dedicated billing assistant that knows your store inside out. It handles the boring stuff like generating invoices or updating license keys so you can stay focused on growing your business. ## Tools ### get_license_key_instance Use this to get a specific license key instance. It helps you see which user is using a key. ### get_me Use this to get the currently authenticated user. It helps you check your own account status. ### get_order Use this to get details for a specific order. It helps you check the status of a past purchase. ### list_products Use this to list all products. It helps you see your entire inventory in one view. ### list_files Use this to list all files. It helps you see all content uploaded to your store. ### update_webhook Use this to update a webhook. It helps you change how your store sends data to other apps. ### activate_license Use this to turn on a user's license key. It helps you grant access to your software immediately. ### cancel_subscription This stops a recurring payment for a customer. It is the fastest way to handle churn requests. ### create_checkout Use this to create a new checkout for a customer. It helps you start the payment process quickly. ### create_customer Use this to create a new customer in your store. It helps you add new users to your database. ### create_discount Use this to create a new discount code. It helps you launch new sales or promotions. ### create_usage_record Use this to create a usage record for a subscription. It helps you track how much a user has used. ### create_webhook Use this to create a new webhook. It helps you connect your store to other apps. ### deactivate_license Use this to turn off a license key. It helps you revoke access to your software. ### delete_discount Use this to delete an existing discount. It helps you clean up old promotions. ### delete_webhook Use this to delete a webhook. It helps you remove old connections to other apps. ### generate_order_invoice Use this to generate an invoice for a specific order. It helps you provide receipts to customers. ### generate_subscription_invoice Use this to generate a subscription invoice. It helps you provide billing details for recurring plans. ### get_affiliate Use this to get details for a specific affiliate. It helps you manage your referral program. ### get_checkout Use this to get details for a specific checkout. It helps you check the status of a pending payment. ### get_customer Use this to get details for a specific customer. It helps you find user information quickly. ### get_discount_redemption Use this to get a specific discount redemption. It helps you see how a customer used a code. ### get_discount Use this to get details for a specific discount. It helps you check the rules of a promotion. ### get_file Use this to get a specific file from your store. It helps you access uploaded content. ### get_license_key Use this to get a specific license key. It helps you check the status of a user's license. ### get_order_item Use this to get a specific order item. It helps you see exactly what a customer bought. ### get_price Use this to get details for a specific price. It helps you check the cost of a product. ### get_product Use this to get details for a specific product. It helps you check the status of an item in your store. ### get_store Use this to get details for a specific store. It helps you manage your different business hubs. ### get_subscription_invoice Use this to get a specific subscription invoice. It helps you find billing details for a plan. ### get_subscription_item_current_usage Use this to get current usage for a subscription item. It helps you see how much a user has used. ### get_subscription_item Use this to get a specific subscription item. It helps you see the components of a plan. ### get_subscription Use this to get details for a specific subscription. It helps you check a user's recurring plan. ### get_usage_record Use this to get a specific usage record. It helps you see a history of user activity. ### get_variant Use this to get details for a specific variant. It helps you see different versions of a product. ### get_webhook Use this to get details for a specific webhook. It helps you manage your store's outgoing data. ### list_affiliates Use this to list all affiliates. It helps you manage your entire referral network. ### list_checkouts Use this to list all checkouts. It helps you monitor all pending payments in your store. ### list_customers Use this to list all customers. It helps you see your entire user base in one view. ### list_discount_redemptions Use this to list all discount redemptions. It helps you see how people are using your codes. ### list_discounts Use this to list all discounts. It helps you see all your active and expired promotions. ### list_license_key_instances Use this to list all license key instances. It helps you see every active key in your system. ### list_license_keys Use this to list all license keys. It helps you manage your software access keys. ### list_order_items Use this to list all order items. It helps you see a breakdown of every purchase made. ### list_orders Use this to list all orders. It helps you see your store's total transaction history. ### list_prices Use this to list all prices. It helps you see all the different price points in your store. ### list_stores Use this to list all stores. It helps you manage multiple business hubs at once. ### list_subscription_invoices Use this to list all subscription invoices. It helps you see all recurring billing history. ### list_subscription_items Use this to list all subscription items. It helps you see the details of all your plans. ### list_subscriptions Use this to list all subscriptions. It helps you see who is currently paying for your service. ### list_usage_records Use this to list all usage records. It helps you track how your users are consuming your product. ### list_variants Use this to list all variants. It helps you see all different versions of your products. ### list_webhooks Use this to list all webhooks. It helps you see all active integrations for your store. ### refund_order Use this to issue a refund for an order. It helps you resolve customer billing issues instantly. ### refund_subscription_invoice Use this to issue a refund for a subscription invoice. It helps you quickly correct recurring billing errors. ### update_customer Use this to update a customer's information. It helps you keep your user records accurate. ### update_license_key Use this to update a license key. It helps you modify existing software access rules. ### update_subscription_item Use this to update a subscription item. It helps you modify specific parts of a user's plan. ### update_subscription Use this to update a subscription. It helps you change a user's plan or billing details. ### validate_license Use this to validate a license key. It helps you check if a user's key is still active and valid. ## Prompt Examples **Prompt:** ``` Show me a list of all my active stores. ``` **Response:** ``` I've pulled your store data. 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) **Status:** Active **Price:** $49.00 **Active Subscribers:** 152 ``` ## Capabilities ### Refund customer orders Issue refunds for orders or subscription invoices instantly through your chat. ### Create new customers Add new users to your store with a single voice command. ### Manage product catalogs List all products and check their current pricing and availability. ### Handle discount codes Create, delete, and check discount redemptions for your store. ### Manage license keys Activate, deactivate, and validate software license keys for users. ### Generate invoices Pull up and generate invoices for specific orders or subscriptions. ### Monitor store webhooks List and create webhooks to keep your external systems in sync. ## Use Cases ### Handling a customer overcharge A customer contacts support about a double charge. The agent uses `refund_order` to issue a refund in seconds without leaving the chat. ### Onboarding a new user A new user signs up. The agent uses `create_customer` to add them to the store and set up their profile immediately. ### Checking product status A user asks about the price of a specific plan. The agent uses `get_product` to pull the current price and status from the store. ### Launching a flash sale The founder wants to run a 20% off sale. The agent uses `create_discount` to launch the promotion instantly across the store. ## Benefits - Faster refunds: Use `refund_order` and `refund_subscription_invoice` to resolve billing issues instantly while chatting with users. - Easy inventory: Use `list_products` and `get_product` to keep your catalog organized and check prices on the fly. - Dynamic pricing: Use `create_discount` and `delete_discount` to run sales or provide special offers to your VIP customers. - Automated licensing: Use `activate_license` and `deactivate_license` to manage software access without manual database entries. - Better tracking: Use `list_webhooks` and `create_webhook` to ensure your external systems stay in sync with your payment data. - Simple customer updates: Use `update_customer` and `create_customer` to keep your user records accurate without manual data entry. ## How It Works The bottom line is you get a hands-free way to manage your entire Lemon Squeezy store through a chat interface. 1. Subscribe to the Lemon Squeezy MCP on the Vinkius marketplace. 2. Paste your Lemon Squeezy API key into your AI client settings. 3. Ask your agent to perform tasks like listing customers or creating checkouts. ## Frequently Asked Questions **Can I use the Lemon Squeezy MCP to issue refunds?** Yes, you can use this Connector to issue refunds for both individual orders and subscription invoices directly through your AI client. This saves your support team from having to log into the dashboard for every refund request. **How does the Lemon Squeezy MCP handle customer data?** Your AI agent can retrieve customer details, create new profiles, and update existing information like emails or store associations. It makes managing your user base much faster during live support sessions. **Can I manage my license keys with the Lemon Squeezy MCP?** You can use the Connector to activate, deactivate, and validate license keys. This is great for software companies that need to grant or revoke access to their products instantly. **Does the Lemon Squeezy MCP work with my existing store?** Yes, it connects to your existing Lemon Squeezy account. You can use it to list products, check prices, and manage your entire inventory through your preferred AI client. **Can I create discount codes using the Lemon Squeezy MCP?** You can create and delete discount codes, as well as check discount redemptions. This allows you to manage your marketing promotions and VIP offers without leaving your workspace. **How do I set up the Lemon Squeezy MCP for my SaaS?** You just need to subscribe to the Connector on Vinkius and provide your Lemon Squeezy API key. Once connected, your AI client can start performing store and payment actions for you. **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.