Usage & Examples

Looking up orders:

• "Show me order #1234"
• "List all pending orders"
• "Find orders from customer john@example.com"
• "What are the most recent 5 orders?"
• "Show me unfulfilled orders"

Transactions & disputes:

• "Show me the transaction details for order #1234"
• "What shipping methods are available for this order?"
• "Show me the activity trail for order #1234"

Orders are read-only in this release. No status changes, no address edits, no notes, no marking paid, no accepting disputes, no bulk operations, no refunds. FluentCart gives no supported way to undo any of them, so none is exposed. Investigating an order is what the AI is for here; the fixing still happens in the admin panel.

Finding products:

• "List all products"
• "Search for products with 'license' in the name"
• "Show me product #42"
• "What are my digital products?"

Creating and updating (needs FLUENTCART_WRITE_MODE=reversible):

• "Create a new digital product called 'Starter Plan' at $29"
• "Create a physical product called 'T-Shirt' at $25"
• "Update the description and title of product #42"

Variants:

• "List all variations for product #42"
• "Create a new variation: Size Large, Colour Blue, price $35" (a write)
• "Update the title of variant #7" (a write)

Downloads & licences:

• "Show downloadable files for product #42"
• "Generate a download URL for file #3 on product #42"

Categories & tags:

• "List all product categories"

Deleting a product, duplicating one, bulk-editing the catalogue and rewriting the pricing table are not exposed — none can be undone through the API.

Finding customers:

• "Find the customer with email jane@example.com"
• "List all customers"
• "Search for customers named 'Smith'"

Customer details:

• "Show me customer #15's full profile"
• "What's the order history for customer #15?"
• "What's the lifetime value for customer #15?"
• "Recalculate the LTV for customer #15"

Managing customers (needs FLUENTCART_WRITE_MODE=reversible):

• "Create a new customer: Jane Smith, jane@example.com"
• "Update customer #15's phone number to +44 7700 900000"

Addresses:

• "Show all addresses for customer #15"

Adding, editing and deleting addresses, and bulk customer operations, are not exposed.

Viewing subscriptions:

• "List all active subscriptions"
• "Show subscription #42"
• "What subscriptions does customer #15 have?"
• "Which subscriptions renew in the next two weeks?"
• "List renewals due next week"
• "Show renewal #42 and the subscription it belongs to"
• "Which subscriptions have a pending skipped period?"

Changing the billing-cycle limit (needs FLUENTCART_WRITE_MODE=reversible):

• "Show me subscription #42 first, then change its total number of billing cycles to 12"

The server reads the subscription first, checks that the current bill_times and bill_count still match the values it was given, and reads it again before it reports success. 0 means unlimited billing cycles; a finite limit cannot be at or below the cycles already billed. The update applies only to store-billed manual or system subscriptions. Gateway-billed automatic subscriptions fail closed before a write. It does not pause, resume, reactivate, cancel, charge, create, skip, void, resend, synchronise a renewal, or re-sync a subscription with its payment gateway. Those lifecycle and money-adjacent actions remain in the FluentCart admin because 1.6 can change scheduled charges and renewal state in ways this server cannot prove it can restore.

Creating coupons (needs FLUENTCART_WRITE_MODE=reversible):

• "Create a coupon code SUMMER25 for 25% off"
• "Make a $10 fixed discount coupon that expires on December 31st"
• "Create a coupon that only works on digital products"
• "Change the expiry date on coupon #5"

Reading coupons:

• "List all active coupons"
• "Show me coupon #5"
• "Check if product #42 is eligible for coupon SUMMER25"

Order bumps:

• "List all order bumps"
• "Create an order bump: offer Product #42 at 20% off when buying Product #10" (a write)
• "Update the discount on order bump #3" (a write)

Deleting a coupon or a bump isn't exposed, and neither is applying a coupon to an existing order — that one changes what a customer is charged.

This is where it gets genuinely useful. Instead of staring at charts in the admin panel, you just ask questions.

Revenue:

• "What's my revenue this month?"
• "Show me revenue by day for the last 30 days"
• "Compare this month's sales to last month"
• "What's the sales growth trend?"

Orders:

• "How many orders did I get this week?"
• "Show me the order chart for the last 90 days"
• "What are my quick order stats?"
• "List recent unfulfilled orders"

Products:

• "What are my top 10 selling products?"
• "Show me product performance for product #42"
• "Which variants sell the most?"

Customers:

• "Show me new vs returning customer breakdown"
• "How many new signups this month?"
• "Find repeat customers"

Subscriptions:

• "Show me the subscription chart"
• "What future renewals are coming up?"

Dashboard:

• "Give me an overview of the store"
• "Show me the dashboard summary"
• "What are today's stats?"

Zones & methods (creating and updating needs FLUENTCART_WRITE_MODE=reversible):

• "List all shipping zones"
• "What shipping methods are available?"
• "Create a shipping zone called 'Europe' with countries PL, DE, FR"
• "Add a flat-rate shipping method at £5.99 to the Europe zone"
• "Add a free shipping method with £50 minimum order to zone #1"
• "Rename zone #1 and add Italy to it"

Shipping classes:

• "List all shipping classes"
• "Create a shipping class called 'Heavy Items' with £3 extra per item" (a write)

Deleting a zone, method or class isn't exposed, and neither is reordering zones.

Rates & classes (creating and updating needs FLUENTCART_WRITE_MODE=reversible):

• "List all tax classes"
• "What's the VAT rate for Poland?"
• "Show me EU VAT rates for all member states"
• "Create a 23% VAT rate for Poland"
• "Correct the rate on tax rule #7 to 21%"

Settings & records:

• "What are the current tax settings?"
• "Show me tax records for January"

Global tax settings (needs FLUENTCART_WRITE_MODE=reversible) are a reviewed reversible change: the server reads the complete settings document, merges only the named fields, writes it, then reads it back before reporting what changed. Changing the EU VAT configuration and marking records as filed are not exposed. Enabling tax for the first time can create a Standard tax class, which restoring settings cannot remove, so check that consequence before delegating it.

Templates:

• "List all email notification templates"
• "Show me the order confirmation email template"
• "Preview the new order email template"

Settings:

• "What shortcodes can I use in email templates?"

Editing templates, toggling notifications and changing sender settings are not exposed. An email that goes out to customers is not something an undo button covers.

• "List all roles"
• "Who has store manager access?"
• "List all users and their roles"

Creating and editing roles is not exposed. Permission changes are exactly the sort of thing you want a human clicking through deliberately.

Store settings (read-only — configuration changes are not exposed):

• "Show me the current store settings"
• "What payment methods are available?"
• "What are the current module settings?"

Integrations:

• "List all installed addons"
• "Show the global settings for the Mailchimp integration"
• "What integration feeds are configured?"

Product options (creating and updating needs FLUENTCART_WRITE_MODE=reversible):

• "List all attribute groups"
• "Create a new attribute group called 'Sizes'"
• "Add terms Small, Medium, Large to the Sizes attribute group"
• "Rename the 'Sizes' group to 'Clothing Sizes'"

Files & templates:

• "Show me the print templates for invoices"
• "List all uploaded files"

File uploads are not available through this server. FluentCart expects multipart file data for them, which this JSON MCP surface deliberately does not send.

Activity log:

• "Show me recent activity"
• "What happened in the last 24 hours?"

Labels:

• "List all labels"

Order notes and label creation are not exposed; neither can be removed through the API once written.

Public endpoints:

• "Search public products for 'starter'"

Lookup data:

• "List all countries"
• "Show me state/province info for the US"
• "What filter options are available?"