Lemon Squeezy MCP. Manage billing, refunds, and customer data via chat.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Lemon Squeezy (Merchant of Record & Payments) MCP Server lets your AI client manage billing and payments directly through natural conversation.
You'll create checkouts, update customer records, generate invoices, and process refunds for any SaaS business flow—all without leaving your dev environment.
What your AI agents can do
Activate license
Turns on a specific license key so the user can access the service.
Cancel subscription
Stops a customer's recurring billing plan immediately.
Create checkout
Generates a new payment link for a customer to complete a purchase.
Your agent can create checkouts, generate invoices (for orders or subscriptions), and issue refunds for completed transactions.
You can list all customers, get specific customer profiles, and update their details like email or status directly through conversation.
The server lets you retrieve active subscriptions, list invoices, change subscription items, and even cancel entire service plans.
You can list available discounts, get specific discount details, and track when a discount is redeemed by users.
Retrieve granular usage records or create new ones to accurately track how customers use your product's resources for billing purposes.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
Lemon Squeezy (Merchant of Record & Payments): 60 Tools
Use these tools to manage every aspect of your e-commerce backend, from listing customers and products to processing refunds and managing subscriptions.
019e5d2cactivate license
Turns on a specific license key so the user can access the service.
019e5d2ccancel subscription
Stops a customer's recurring billing plan immediately.
019e5d2ccreate checkout
Generates a new payment link for a customer to complete a purchase.
019e5d2ccreate customer
Adds a brand-new user record into your system.
019e5d2ccreate discount
Sets up a temporary discount code or promotion.
019e5d2ccreate usage record
Manually adds usage data to track resource consumption for billing.
019e5d2ccreate webhook
Creates a dedicated URL endpoint that sends notifications when an event happens in Lemon Squeezy.
019e5d2cdeactivate license
Revokes access by turning off a specific license key.
019e5d2cdelete discount
Removes an existing discount code or promotion entirely.
019e5d2cdelete webhook
Removes a previously created notification endpoint (webhook).
019e5d2cgenerate order invoice
Creates and issues the final bill for a completed purchase order.
019e5d2cgenerate subscription invoice
Generates a detailed invoice showing charges for recurring subscriptions.
019e5d2cget affiliate
Retrieves information about a specific partner or affiliate user.
019e5d2cget checkout
Looks up the details of an existing payment checkout link.
019e5d2cget customer
Pulls all profile and billing data for a single customer ID.
019e5d2cget discount
Gets the rules and status for a specific discount code.
019e5d2cget discount redemption
Retrieves details on when and how a discount was used by a customer.
019e5d2cget file
Pulls a specific file associated with an order or account.
019e5d2cget license key
Retrieves the full string for a specific license key.
019e5d2cget license key instance
Gets details about how a license key was used at a specific time.
019e5d2cget me
Pulls the profile data of the user who is currently logged into Lemon Squeezy.
019e5d2cget order
Retrieves all details (items, total, date) for a specific purchase order.
019e5d2cget order item
Gets detailed information about one single item within an order.
019e5d2cget price
Pulls the current cost and currency details for a given price point.
019e5d2cget product
Retrieves all data, including features and pricing, for a specific product sold on your store.
019e5d2cget store
Gets specific settings and identifiers for one of your Lemon Squeezy stores.
019e5d2cget subscription
Pulls the current status and renewal details for an active subscription plan.
019e5d2cget subscription invoice
Retrieves a specific invoice detailing charges for a recurring service.
019e5d2cget subscription item
Gets billing information for one component (e.g., 'Premium Access') within a subscription.
019e5d2cget subscription item current usage
Checks how much of a resource (like API calls) has been used this cycle.
019e5d2cget usage record
Gets the specifics for one usage record, including timestamps and amounts.
019e5d2cget variant
Retrieves details about a specific version or variation of a product.
019e5d2cget webhook
Checks the settings and URL for a notification webhook.
019e5d2clist affiliates
Lists all partners who are connected to your platform.
019e5d2clist checkouts
Shows a list of all checkout links that have been created.
019e5d2clist customers
Returns a paginated list of every customer record you have in the system.
019e5d2clist discount redemptions
Lists all instances where a discount code was successfully used.
019e5d2clist discounts
Shows an overview of all available promotion codes and discounts.
019e5d2clist files
Retrieves names and metadata for all files uploaded to the platform.
019e5d2clist license key instances
Lists every recorded instance where a license key was activated or used.
019e5d2clist license keys
Shows an overview of all purchased and available license keys.
019e5d2clist order items
Gets a list of all products that were included in specific orders.
019e5d2clist orders
Returns a paginated list of every completed or pending order.
019e5d2clist prices
Lists all the different pricing amounts and currencies you use.
019e5d2clist products
Provides an overview listing every single product sold through your Lemon Squeezy store.
019e5d2clist stores
Shows a list of all independent storefronts connected to your account.
019e5d2clist subscription invoices
Lists all generated billing statements for subscription services.
019e5d2clist subscription items
Lists every distinct item or component that can be sold via a subscription plan.
019e5d2clist subscriptions
Shows an overview of all active and inactive customer subscriptions.
019e5d2clist usage records
Returns a list summary of usage records for billing purposes.
019e5d2clist variants
Lists every available product variation (e.g., 'Pro' vs 'Enterprise').
019e5d2clist webhooks
Shows an overview of all notification webhooks you have set up.
019e5d2crefund order
Issues a full or partial refund for a completed order.
019e5d2crefund subscription invoice
Processes a refund specifically against a subscription invoice.
019e5d2cupdate customer
Changes customer details, like their email address or name.
019e5d2cupdate license key
Modifies the status or ownership of an existing license key.
019e5d2cupdate subscription
Makes changes to an entire subscription plan (e.g., changing renewal date).
019e5d2cupdate subscription item
Changes billing details for a single component within a subscription item.
019e5d2cupdate webhook
Modifies the URL or settings of an existing webhook endpoint.
019e5d2cvalidate license
Checks if a license key is currently active and legitimate.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Lemon Squeezy (Merchant of Record & Payments), then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Lemon Squeezy MCP Server - Billing & Payments Management
Your agent handles all billing and payments straight through natural conversation using this server. You'll create checkouts, update customer records, generate invoices, and process refunds for any SaaS business flow—all without leaving your dev environment.
Customer Accounts and Store Setup
You can list every store connected to your account using list_stores, and you'll get full details on one specific storefront with get_store. To handle users, the agent lets you create new accounts via create_customer or pull all profile data for a single user ID using get_customer; you can also update their personal info with update_customer.
For partners, you list all connected affiliates through list_affiliates, and you'll grab specific partner details by calling get_affiliate. You'll get the currently logged-in user's profile data using get_me.
Product Catalog and Pricing Details
The server lets you list every product sold via your store with list_products, and for any given item, you can retrieve all its features and pricing by calling get_product. You'll get specific details about a product variation using get_variant or pull the current cost and currency information using get_price. When processing an order, you list all completed orders with list_orders, then pull every detail—items, total, date—for one specific purchase order via get_order; you can also get a list of products included in those orders using list_order_items or check the details for just one item inside an order by calling get_order_item.
You'll see all available pricing structures with list_prices, and you'll pull records for every specific product variation listed via list_variants.
Payments, Invoicing, and Refunds
The agent manages transactions by letting you create new payment links using create_checkout, or check the details of an existing link with get_checkout. To handle billing statements, you generate a final bill for completed purchases via generate_order_invoice or get a detailed invoice showing recurring charges through generate_subscription_invoice. You can issue full or partial refunds against a finished purchase order using refund_order, and if it's a subscription service, you process the refund directly on that billing statement with refund_subscription_invoice.
Subscription Management
For recurring revenue, you list all customer subscriptions—active or inactive—using list_subscriptions. You can retrieve the current status and renewal information for any plan by calling get_subscription, or pull a specific invoice detailing charges with get_subscription_invoice. The server lets you see every distinct component that can be sold under a subscription via list_subscription_items and get billing details for one part, like 'Premium Access,' using get_subscription_item.
You'll check how much of a resource was used this cycle with get_subscription_item_current_usage, or view usage records in general using list_usage_records. If you gotta make changes, the agent lets you update an entire plan using update_subscription or modify billing details for one component using update_subscription_item; and if a customer's service is done, you stop their recurring charges immediately with cancel_subscription.
Discounts and Promotions Control
You can list all available discount codes and promotions by calling list_discounts. To set up a promotion, the agent lets you create one using create_discount, or get its current rules and status via get_discount. You track usage by listing every instance where a code was redeemed with list_discount_redemptions, and pulling specific redemption details about when and how it was used through get_discount_redemption.
If a promotion is stale, you remove it entirely using delete_discount.
Usage Tracking and Billing Records
The agent makes sure your billing is accurate. You can manually add usage data to track resource consumption for billing purposes with create_usage_record, or check the specifics of one recorded instance (including timestamps) by calling get_usage_record. For a summary, you get a list of all usage records using list_usage_records.
Admin and System Tools
You manage your system keys with this server. You list purchased license keys using list_license_keys, and you can retrieve the full string for any key by calling get_license_key. The agent lets you check if a key is active and legitimate via validate_license, or turn access on/off using activate_license/deactivate_license. You track history with list_license_key_instances and get details about a specific usage time with get_license_key_instance.
For webhooks, you list all notification endpoints via list_webhooks, create one new endpoint using create_webhook, or check existing settings by calling get_webhook; you can modify an existing webhook's URL or settings with update_webhook and delete it entirely with delete_webhook. Finally, if you need to handle files associated with orders or accounts, the agent lets you list all uploaded file names using list_files, and pull a specific file using get_file.
How Lemon Squeezy MCP Works
- 1 Subscribe to this MCP server and input your Lemon Squeezy API Key.
- 2 Your AI client (Claude, Cursor, etc.) uses the key to authenticate with the Lemon Squeezy APIs.
- 3 You describe the task conversationally (e.g., 'Refund order 123 for $50'). Your agent executes the necessary tool calls and reports the result.
The bottom line is: you get a single chat interface that acts as your billing department, eliminating the need to jump between Lemon Squeezy dashboards and API documentation.
Who Is Lemon Squeezy MCP For?
This tool is for SaaS founders, support engineers, and operations leads. It's built for people who are tired of spending half their day context-switching—jumping from a CRM to a billing dashboard just to check an order status or apply a refund. If your job requires managing customer lifecycles and payments, this saves you time.
Checks product catalog details (get_product) or lists all stores (list_stores) to validate pricing tiers without leaving their development environment.
Responds to customer billing queries by retrieving specific customer data (get_customer) and processing refunds (refund_order) in a single chat session.
Automates complex reporting tasks, like listing all subscriptions (list_subscriptions) or checking total usage records (list_usage_records), to audit business health.
What Changes When You Connect
- Saves time on lookups. Instead of navigating to the 'Customers' tab, calling
list_customerslets your agent pull a list directly into your workflow. You immediately know who you need to talk to. - Streamlines billing fixes. When a customer calls about an overcharge, your agent can execute
get_orderand then runrefund_orderin one sequence. No copying IDs between tabs—it's all conversational. - Keeps inventory fresh. Need to check if the 'Enterprise Plan' is active? Use
get_product. You get back specific pricing, feature lists, and status immediately, without opening a browser tab. - Automates setup. Onboarding a new client requires several steps—creating the user, setting up billing, etc. Your agent can run
create_customerfollowed bycreate_checkout, handling the whole sequence for you. - Provides audit trails. When an operations lead needs to see everything that happened with a specific account, they simply ask the agent to check
list_usage_records. It aggregates data from multiple sources automatically.
Real-World Use Cases
The support ticket: Customer X is billed wrong.
A customer calls in because their subscription seems too high. Instead of asking the user to email screenshots, the agent prompts for the account ID. The agent runs get_customer, finds the current plan via get_subscription, and then uses generate_subscription_invoice to show the exact charges, resolving the query instantly.
The sales audit: Need to validate a trial discount.
A salesperson needs to quickly confirm if a special promotion code is still valid before quoting it. They ask the agent to check list_discounts. The agent runs get_discount for that specific coupon, confirming its expiry date and usage limits right there in the chat.
The dev deployment: New product needs a test checkout.
A developer wants to hard-test a new payment flow without using real money. They ask the agent to create_checkout. The agent generates the necessary, temporary payment link and provides it for immediate testing, bypassing manual setup steps.
The compliance check: Need to reverse a charge.
A manager detects an error on a recent sale. Instead of manually going through the order history, they ask the agent to find and refund_order for Order ID 998. The tool verifies payment status and executes the refund command in one step.
The Tradeoffs
Treating it like a simple database search.
Asking the agent to 'Just list all orders' without specifying date ranges or customer IDs. This often returns too much data, making the answer useless and slow.
→
Always narrow the scope. Instead of listing everything with list_orders, ask for details on a specific ID: 'What is the status of order 123?' Use get_order to pull exactly what you need.
Trying to manually update billing data.
Using an external spreadsheet or CMS tool to change a customer's email address or subscription plan. This often leads to synchronization errors and outdated records.
→
Use the dedicated tools. To correct details, call update_customer. If you need to change the service plan, use update_subscription.
Forgetting the payment status.
Assuming a discount code was applied when it might have expired or been redeemed already. This leads to failed transactions and angry users.
→
Always check first. Use get_discount_redemption to verify if the coupon is active, valid, and hasn't hit its usage limit before attempting any transaction.
When It Fits, When It Doesn't
You should use this MCP server if your core business logic revolves around billing cycles, customer identity management, or product catalog synchronization. You need a unified view of payments—from the initial create_checkout to the final refund_order.
Don't use it if you only need general data that doesn't touch money (e.g., just listing files, which might be better handled by a dedicated file storage API). If your workflow is simple and non-transactional—say, 'just list all my stores'—you can likely get away with other APIs. But because this server manages the entire financial lifecycle (get_order, list_subscriptions), it’s essential for any system that needs to be auditable or handle state changes related to revenue.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Lemon Squeezy. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 60 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Billing records shouldn't require four different dashboards and a dozen copy-pasted IDs.
Today, when your support team member has a billing query, they typically start in the CRM. They find the customer ID. Then they open the dedicated Lemon Squeezy tab to check the subscription status. If that's wrong, they jump to the 'Orders' section to see invoices, and if they need to fix it, they have to copy the order ID into a separate refund tool. It’s painful context switching.
With this MCP server, your agent handles all those steps in one chat window. You ask: 'What did Customer X pay for last month?' The agent runs `get_customer`, pulls `list_subscriptions` data, and generates the invoice using `generate_subscription_invoice`. You get a single answer with zero tab switching.
Lemon Squeezy (Merchant of Record & Payments) MCP Server: Manage revenue lifecycle.
The biggest pain points we eliminate are the manual lookups for status and the difficulty in tracking usage. You don't have to remember which tool handles cancellations (`cancel_subscription`) versus which one processes refunds (`refund_order`). The agent knows the right sequence.
This gives your development team a single, reliable point of truth for billing actions. Your AI client executes complex financial transactions—from creating records with `create_customer` to finalizing payments with `get_checkout`—in an auditable chain.
Common Questions About Lemon Squeezy MCP
How do I check if a specific customer exists using get_customer? +
You provide the unique customer ID. The tool pulls all associated billing and profile data for that single account. This is faster than running list_customers and filtering manually.
Can I refund an order with the refund_order tool? +
Yes, you call refund_order and specify the Order ID. The server validates the payment against Lemon Squeezy's records and issues the reversal through the API.
What is the difference between list_subscriptions and list_customers? +
The tool list_customers gives you profile information (name, email). list_subscriptions only shows active billing plans associated with those customers. You need both for a full picture.
How do I process a refund on a subscription invoice? Use refund_subscription_invoice. +
You use refund_subscription_invoice. This is critical because it targets the recurring billing cycle, ensuring the refund is correctly applied against the service plan's charges, not just a single order.
Does create_checkout handle payments? +
It doesn't process payments itself; it generates the secure checkout link. Your AI client sends the link to the user, and they complete the transaction on Lemon Squeezy’s site.
How do I verify that my API connection credentials are active using get_me? +
You call get_me to confirm your current authentication status. The tool returns details about the authenticated user, confirming if the provided access token is valid and hasn't expired.
If I try to use a discount code that has already been redeemed or expired, how does get_discount handle it? +
The tool will return an error or status indicating the redemption failure. It lets you know if the specific discount ID is invalid, used up, or no longer active within your Lemon Squeezy account.
When I use list_orders, are there limits on how many records I can pull at once? +
The API handles listing in batches. You must check the response payload for pagination details (e.g., next_page_url) to retrieve all order history beyond the initial result set.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Wix eCommerce
Manage products, orders, and inventory on Wix — the complete eCommerce platform for growing online businesses.
Zakeke
Manage customized product designs, 3D configurations, and orders via Zakeke.
Endear Retail CRM
Equip your AI agent to manage retail customers, track orders, and monitor clienteling notes via the Endear API.
You might also like
The Graph (Web3 Indexing)
Index and query blockchain data across EVM and Solana chains. Access transfers, holders, swaps, and custom subgraphs directly.
Mailingwork
Execute professional email marketing campaigns with advanced segmentation, A/B testing, and GDPR-compliant list management.
Eventbrite Alternative
Manage your Eventbrite events — audit organizations, attendees, and orders via AI.