Tool Reference

Every tool I built into FluentCart MCP, listed by module. 194 tools covering orders, products, customers, subscriptions, reports, and more.

This is the complete inventory. Every tool, every module, every HTTP method. I organised 194 tools into 17 modules so the AI (and you) can find what it needs.

You'll never need to call these yourself — the AI picks the right tool based on what you ask. But if you want to know exactly what's possible, or you want to verify that a specific capability exists before asking for it, this is your reference.

Every tool follows the naming pattern fluentcart_{resource}_{action}.

Relax

This page is a lookup table, not homework. The AI already knows all of this. You're here out of curiosity or because you want to confirm something specific.

Dynamic Mode

Don't fancy loading 194 tool definitions into your LLM context? Fair enough. Start the server with --mode dynamic and you get 3 meta-tools instead:

Tool	What It Does
`fluentcart_search_tools`	Search tools by keyword and optional category. Returns names, titles, descriptions.
`fluentcart_describe_tools`	Get full input schemas and annotations for specific tools (max 10 per request).
`fluentcart_execute_tool`	Execute any tool by name with provided input.

The AI discovers tools on demand instead of loading all 194 upfront. ~96% token reduction (~20K down to ~1.5K). Same tools, same results — just lazily loaded.

Categories for filtering: product, order, customer, coupon, report, subscription, integration, setting, label, activity, note, dashboard, application, public, misc.

Trade-off

Dynamic mode adds 2-3 extra tool calls per workflow (search, describe, then execute). If latency matters more than token budget, stick with the default static mode.

Tool Annotations

I tag every tool with metadata so the AI knows what it's dealing with:

Annotation	What It Means
Read-only	Only reads data. Can't break anything. Call it all day.
Idempotent	Same call, same result. Safe to retry if something times out.
Destructive	Deletes data permanently. The AI should (and usually does) confirm first.
Open-world	Creates new data — orders, products, customers.

The bread and butter. Every support interaction starts with orders.

Tool	Method	What It Does
`fluentcart_order_list`	GET	List orders with pagination, filtering by status, date, customer
`fluentcart_order_get`	GET	Get a single order by ID with full details
`fluentcart_order_create`	POST	Create a new order
`fluentcart_order_update`	PUT	Update order fields (status, notes, custom fields)
`fluentcart_order_delete`	DELETE	Delete an order permanently
`fluentcart_order_mark_paid`	POST	Mark an order as paid (manual payment confirmation)
`fluentcart_order_refund`	POST	Process a refund on an order
`fluentcart_order_change_customer`	POST	Reassign an order to a different customer
`fluentcart_order_create_and_change_customer`	POST	Create a new customer and assign an order to them in one go
`fluentcart_order_create_custom`	POST	Create a custom order with manual line items
`fluentcart_order_update_statuses`	PUT	Bulk-update order statuses
`fluentcart_order_sync_statuses`	POST	Sync order statuses with the payment gateway
`fluentcart_order_update_address`	PUT	Update an order's billing or shipping address
`fluentcart_order_update_address_id`	PUT	Swap which saved address is linked to an order
`fluentcart_order_generate_licenses`	POST	Generate missing licence keys for an order

Transaction-level stuff. Payments, disputes, shipping calculations.

Tool	Method	What It Does
`fluentcart_order_transactions`	GET	List transactions for an order
`fluentcart_order_transaction_get`	GET	Get detailed transaction info
`fluentcart_order_transaction_update_status`	PUT	Update a transaction's status
`fluentcart_order_accept_dispute`	POST	Accept a payment dispute
`fluentcart_order_bulk_action`	POST	Bulk actions on multiple orders
`fluentcart_order_calculate_shipping`	POST	Calculate shipping costs for an order
`fluentcart_order_shipping_methods`	GET	Get available shipping methods
`fluentcart_order_customer_orders`	GET	Get orders for a specific customer

Product CRUD, search, and bulk operations.

Tool	Method	What It Does
`fluentcart_product_list`	GET	List products with pagination and filtering
`fluentcart_product_get`	GET	Get a single product by ID
`fluentcart_product_create`	POST	Create a new product
`fluentcart_product_delete`	DELETE	Delete a product
`fluentcart_product_duplicate`	POST	Duplicate an existing product
`fluentcart_product_bulk_action`	POST	Bulk actions on multiple products
`fluentcart_product_update_detail`	PUT	Update product detail fields
`fluentcart_product_search_by_name`	GET	Search products by name
`fluentcart_product_search_variant_by_name`	GET	Search product variants by name
`fluentcart_product_search_variant_options`	GET	Search variant options
`fluentcart_product_suggest_sku`	GET	Generate a SKU suggestion
`fluentcart_product_fetch_by_ids`	POST	Fetch multiple products by ID
`fluentcart_product_find_subscription_variants`	GET	Find subscription-enabled variants

Pricing, bundles, tax classes, shipping classes, stock management.

Tool	Method	What It Does
`fluentcart_product_pricing_get`	GET	Get pricing details for a product
`fluentcart_product_pricing_update`	POST	Save product pricing (full product payload with variants)
`fluentcart_product_pricing_widgets`	GET	Get pricing widget configuration
`fluentcart_product_related`	GET	Get related products
`fluentcart_product_bundle_info`	GET	Get bundle composition
`fluentcart_product_bundle_save`	POST	Save bundle configuration
`fluentcart_product_tax_class_update`	PUT	Assign a tax class
`fluentcart_product_tax_class_remove`	DELETE	Remove tax class
`fluentcart_product_shipping_class_update`	PUT	Assign a shipping class
`fluentcart_product_shipping_class_remove`	DELETE	Remove shipping class from a product
`fluentcart_product_manage_stock_update`	PUT	Toggle inventory management on/off
`fluentcart_product_inventory_update`	PUT	Update stock levels

Variation management for variable products.

Tool	Method	What It Does
`fluentcart_variant_list_all`	GET	List all variants across products
`fluentcart_variant_list`	GET	List variants for a specific product
`fluentcart_variant_create`	POST	Create a new variant
`fluentcart_variant_update`	PUT	Update a variant
`fluentcart_variant_delete`	DELETE	Delete a variant
`fluentcart_variant_set_media`	PUT	Set media/images for a variant
`fluentcart_variant_pricing_table_update`	PUT	Update variant pricing tiers
`fluentcart_product_variant_option_update`	PUT	Update a variant option
`fluentcart_variant_fetch_by_ids`	POST	Fetch multiple variants by ID
`fluentcart_variant_upgrade_paths`	GET	Get upgrade paths for a variant

Downloads, upgrade paths, taxonomies, product-level integrations.

Tool	Method	What It Does
`fluentcart_product_sync_downloadable_files`	POST	Sync downloadable file list
`fluentcart_product_downloadable_update`	PUT	Update a downloadable file
`fluentcart_product_downloadable_delete`	DELETE	Remove a downloadable file
`fluentcart_product_downloadable_url`	GET	Generate a download URL
`fluentcart_product_upgrade_settings`	GET	Get upgrade settings
`fluentcart_product_upgrade_path_save`	POST	Save an upgrade path
`fluentcart_product_upgrade_path_update`	PUT	Update an existing upgrade path
`fluentcart_product_upgrade_path_delete`	DELETE	Delete an upgrade path
`fluentcart_product_terms`	GET	Fetch available taxonomy terms
`fluentcart_product_terms_by_parent`	GET	Get child terms of a parent
`fluentcart_product_terms_add`	POST	Add terms to a product
`fluentcart_product_taxonomy_sync`	POST	Sync taxonomy terms
`fluentcart_product_taxonomy_delete`	DELETE	Remove taxonomy terms
`fluentcart_product_integrations`	GET	Get product-level integration settings
`fluentcart_product_integration_settings`	GET	Get specific integration settings
`fluentcart_product_integration_save`	POST	Save product integration config
`fluentcart_product_integration_delete`	DELETE	Remove a product integration
`fluentcart_product_integration_feed_status`	POST	Toggle product integration feed status

Profiles, addresses, stats, user linking.

Tool	Method	What It Does
`fluentcart_customer_list`	GET	List customers with search and pagination
`fluentcart_customer_get`	GET	Get customer profile by ID
`fluentcart_customer_create`	POST	Create a new customer
`fluentcart_customer_update`	PUT	Update customer info
`fluentcart_customer_update_additional_info`	PUT	Update additional customer fields
`fluentcart_customer_stats`	GET	Get customer statistics
`fluentcart_customer_recalculate_ltv`	POST	Recalculate lifetime value
`fluentcart_customer_addresses`	GET	List customer addresses
`fluentcart_customer_address_select`	GET	Get address dropdown data
`fluentcart_customer_address_create`	POST	Create a new address
`fluentcart_customer_address_update`	PUT	Update an address
`fluentcart_customer_address_delete`	DELETE	Delete an address
`fluentcart_customer_address_make_primary`	POST	Set an address as primary
`fluentcart_customer_attachable_users`	GET	Find WordPress users that can be linked
`fluentcart_customer_attach_user`	POST	Link a WordPress user to a customer
`fluentcart_customer_detach_user`	POST	Unlink a WordPress user
`fluentcart_customer_bulk_action`	POST	Bulk customer operations

The full subscription lifecycle. List, inspect, pause, resume, cancel, reactivate.

Tool	Method	What It Does
`fluentcart_subscription_list`	GET	List subscriptions with filtering
`fluentcart_subscription_get`	GET	Get subscription by ID
`fluentcart_subscription_fetch`	GET	Fetch subscription with gateway sync
`fluentcart_subscription_cancel`	POST	Cancel a subscription
`fluentcart_subscription_pause`	POST	Pause a subscription
`fluentcart_subscription_resume`	POST	Resume a paused subscription
`fluentcart_subscription_reactivate`	POST	Reactivate an expired/cancelled subscription

Statuses: active, trialing, paused, failing, past_due, expiring, canceled, expired, completed

Creation, application, and eligibility checks.

Tool	Method	What It Does
`fluentcart_coupon_list`	GET	List coupons with pagination
`fluentcart_coupon_get`	GET	Get coupon by ID
`fluentcart_coupon_create`	POST	Create a new coupon
`fluentcart_coupon_update`	PUT	Update a coupon
`fluentcart_coupon_delete`	DELETE	Delete a coupon
`fluentcart_coupon_apply`	POST	Apply a coupon to an order
`fluentcart_coupon_cancel`	POST	Remove a coupon from an order
`fluentcart_coupon_reapply`	POST	Re-apply a previously removed coupon
`fluentcart_coupon_check_eligibility`	POST	Check if a product qualifies
`fluentcart_coupon_settings_get`	GET	Get coupon system settings
`fluentcart_coupon_settings_save`	POST	Update coupon system settings

Revenue, sales, orders, and dashboard metrics.

Tool	Method	What It Does
`fluentcart_report_overview`	GET	Full reports overview
`fluentcart_report_meta`	GET	Report metadata and filters
`fluentcart_report_dashboard_stats`	GET	Dashboard statistics
`fluentcart_report_revenue`	GET	Revenue report with date range
`fluentcart_report_revenue_by_group`	GET	Revenue by day/week/month
`fluentcart_report_sales`	GET	Sales report
`fluentcart_report_sales_growth`	GET	Sales growth metrics
`fluentcart_report_sales_growth_chart`	GET	Sales growth chart data
`fluentcart_report_order_chart`	GET	Order volume chart
`fluentcart_report_orders_by_group`	GET	Orders by time period
`fluentcart_report_quick_order_stats`	GET	Quick order summary
`fluentcart_report_recent_orders`	GET	Most recent orders
`fluentcart_report_unfulfilled_orders`	GET	Orders awaiting fulfilment
`fluentcart_report_recent_activities`	GET	Recent store activities

Product performance, customer behaviour, subscription trends, refund analysis.

Tool	Method	What It Does
`fluentcart_report_product`	GET	Product-level report
`fluentcart_report_product_performance`	GET	Detailed product performance
`fluentcart_report_top_products_sold`	GET	Top-selling products
`fluentcart_report_top_sold_variants`	GET	Top-selling variants
`fluentcart_report_customer`	GET	Customer analytics
`fluentcart_report_new_vs_returning`	GET	New vs returning breakdown
`fluentcart_report_daily_signups`	GET	Daily signups
`fluentcart_report_repeat_customers`	GET	Repeat buyers
`fluentcart_report_refund_chart`	GET	Refund trends
`fluentcart_report_refund_by_group`	GET	Refunds by period
`fluentcart_report_subscription_chart`	GET	Subscription trends
`fluentcart_report_future_renewals`	GET	Upcoming renewals
`fluentcart_report_license_summary`	GET	Licence key summary

Post-purchase upsell offers.

Tool	Method	What It Does
`fluentcart_order_bump_list`	GET	List all order bumps
`fluentcart_order_bump_get`	GET	Get order bump by ID
`fluentcart_order_bump_create`	POST	Create an order bump
`fluentcart_order_bump_update`	PUT	Update an order bump
`fluentcart_order_bump_delete`	DELETE	Delete an order bump

Attribute groups and terms — the building blocks of product variations.

Tool	Method	What It Does
`fluentcart_attribute_group_list`	GET	List attribute groups (Size, Colour, etc.)
`fluentcart_attribute_group_get`	GET	Get an attribute group by ID
`fluentcart_attribute_group_create`	POST	Create a new attribute group
`fluentcart_attribute_group_update`	PUT	Update an attribute group
`fluentcart_attribute_group_delete`	DELETE	Delete an attribute group
`fluentcart_attribute_term_list`	GET	List terms in a group
`fluentcart_attribute_term_create`	POST	Create a term (e.g. "Large")
`fluentcart_attribute_term_update`	PUT	Update a term
`fluentcart_attribute_term_delete`	DELETE	Delete a term
`fluentcart_attribute_term_reorder`	PUT	Reorder terms

Third-party addon and feed management.

Tool	Method	What It Does
`fluentcart_integration_list_addons`	GET	List installed addons
`fluentcart_integration_get_global_settings`	GET	Get global integration settings
`fluentcart_integration_save_global_settings`	POST	Save global integration settings
`fluentcart_integration_get_global_feeds`	GET	List all integration feeds
`fluentcart_integration_get_feed_settings`	GET	Get feed settings
`fluentcart_integration_save_feed_settings`	POST	Save feed settings
`fluentcart_integration_change_feed_status`	POST	Enable/disable a feed
`fluentcart_integration_delete_feed`	DELETE	Delete a feed
`fluentcart_integration_get_feed_lists`	GET	Get available list options
`fluentcart_integration_get_dynamic_options`	GET	Get dynamic option values
`fluentcart_integration_get_chained_data`	GET	Get chained/dependent options
`fluentcart_integration_install_plugin`	POST	Install an integration plugin

Store config, payment methods, permissions.

Tool	Method	What It Does
`fluentcart_settings_get_store`	GET	Get store settings
`fluentcart_settings_save_store`	POST	Save store settings
`fluentcart_payment_get_all`	GET	List all payment methods
`fluentcart_payment_get_settings`	GET	Get a specific payment method's settings
`fluentcart_settings_get_modules`	GET	Get module settings
`fluentcart_settings_get_permissions`	GET	Get permissions
`fluentcart_settings_save_permissions`	POST	Save permissions
`fluentcart_settings_get_confirmation_shortcodes`	GET	Get confirmation page shortcodes

Order tagging and organisation.

Tool	Method	What It Does
`fluentcart_label_list`	GET	List all labels
`fluentcart_label_create`	POST	Create a new label
`fluentcart_label_update_selections`	PUT	Update label assignments on orders

Tool	Method	What It Does
`fluentcart_activity_list`	GET	List recent activities
`fluentcart_activity_delete`	DELETE	Delete an activity entry
`fluentcart_activity_mark_read`	POST	Mark as read

Tool	Method	What It Does
`fluentcart_note_attach`	POST	Add a note to an order

Tool	Method	What It Does
`fluentcart_dashboard_onboarding`	GET	Get onboarding status
`fluentcart_dashboard_overview`	GET	Get dashboard overview stats

App init and widgets.

Tool	Method	What It Does
`fluentcart_app_init`	GET	Initialise the app (doubles as a connection test)
`fluentcart_app_get_attachments`	GET	List attachments
`fluentcart_app_upload_attachment`	POST	Upload an attachment
`fluentcart_app_get_widgets`	GET	Get dashboard widget data

Unauthenticated endpoints. For storefronts and bots.

Tool	Method	What It Does
`fluentcart_public_product_views`	GET	Get public product listing
`fluentcart_public_product_search`	GET	Search products publicly
`fluentcart_public_products`	GET	Get public product catalogue
`fluentcart_public_user_login`	POST	Customer login

Lookup data that other tools depend on.

Tool	Method	What It Does
`fluentcart_misc_countries`	GET	List all countries
`fluentcart_misc_country_info`	GET	Get states/provinces for a country
`fluentcart_misc_filter_options`	GET	Get available filter options
`fluentcart_misc_form_search_options`	GET	Search form field options

The Numbers

Module	Tools	Type
Orders (Core + Transactions)	23	CRUD + workflows
Products (Core + Pricing + Variants + Catalogue)	53	Full catalogue management
Customers	17	Profiles, addresses, stats
Subscriptions	7	Lifecycle management
Coupons	11	Discounts and promotions
Reports (Core + Insights)	27	Analytics and metrics
Order Bumps	5	Upsell offers
Product Options	10	Attributes and terms
Integrations	12	Third-party addons
Settings	8	Store configuration
Labels	3	Order tags
Activity	3	Audit log
Notes	1	Order annotations
Dashboard	2	Overview stats
Application	4	App info
Public	4	Public-facing
Miscellaneous	4	Utilities
Total (static mode)	194
Total (dynamic mode)	3	Meta-tools that proxy to all 194

Key endpoints also feature response transforms — order_get, product_get, customer_get and all list endpoints strip HTML blobs, embedded objects, and serialised metadata before returning. Less noise, fewer tokens, same useful data.

Static reference data (countries, filter_options, app_init, report_meta) is cached in-memory with TTL, so repeated calls don't hit the API again.

And there's about 130 more coming in v1.1 — shipping, taxes, email templates, customer portal, checkout, and the niche analytics nobody asked for but I built anyway.

Tool Reference

Dynamic Mode

Tool Annotations

Orders — Core (15 tools)

Orders — Transactions (8 tools)

Products — Core (13 tools)

Products — Pricing (12 tools)

Products — Variants (10 tools)

Products — Catalogue (18 tools)

Customers (17 tools)

Subscriptions (7 tools)

Coupons (11 tools)

Reports — Core (14 tools)

Reports — Insights (13 tools)

Order Bumps (5 tools)

Product Options (10 tools)

Integrations (12 tools)

Settings (8 tools)

Labels (3 tools)

Activity (3 tools)

Notes (1 tool)

Dashboard (2 tools)

Application (4 tools)

Public (4 tools)

Miscellaneous (4 tools)

The Numbers

On this page