Tool Reference

Every tool in FluentCart MCP, listed by module. 274 tools covering orders, products, customers, subscriptions, shipping, tax, reports, and more.

The complete inventory. Every tool, every module, every HTTP method. 274 tools organised into 27 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 274 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 274 upfront. Same tools, same results — just lazily loaded.

Categories for filtering: product, order, customer, coupon, report, subscription, integration, setting, shipping, tax, email, role, file, 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

Every tool is tagged 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
`fluentcart_product_editor_mode_update`	POST	Switch long description between wp-editor and block-editor
`fluentcart_product_create_dummy`	POST	Generate test products for development
`fluentcart_product_variant_option_update`	POST	Configure attribute combinations for advanced_variations products

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_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_orders_simple`	GET	Get a simplified list of customer orders
`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_add`	POST	Add a new address for a customer
`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_list_alt`	GET	List coupons with alternative view/format
`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_dashboard_summary`	GET	Dashboard summary with key metrics and trends
`fluentcart_report_summary`	GET	Report overview with aggregated metrics
`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
`fluentcart_report_top_sold_products`	GET	Top products by units sold with revenue
`fluentcart_report_country_heat_map`	GET	Order distribution by country
`fluentcart_report_cart`	GET	Cart analytics and conversion funnel
`fluentcart_report_order_value_distribution`	GET	Distribution of orders by value ranges
`fluentcart_report_day_and_hour`	GET	Order volume by day of week and hour
`fluentcart_report_item_count_distribution`	GET	Distribution of orders by item count
`fluentcart_report_order_completion_time`	GET	Average time from order to fulfilment
`fluentcart_report_weeks_between_refund`	GET	Time between purchase and refund

Product performance, customer behaviour, subscription trends, refund analysis, retention cohorts, and licence tracking.

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
`fluentcart_report_license_chart`	GET	Licence issuance and activation trends
`fluentcart_report_license_pie_chart`	GET	Licence distribution by status
`fluentcart_report_retention_chart`	GET	Customer retention rates over time
`fluentcart_report_subscription_retention`	GET	Subscription-specific retention analysis
`fluentcart_report_subscription_cohorts`	GET	Subscription cohort analysis
`fluentcart_report_retention_snapshots_status`	GET	Check retention snapshot generation status
`fluentcart_report_retention_snapshots_generate`	POST	Trigger retention snapshot generation
`fluentcart_report_sources`	GET	Traffic and attribution sources

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

Zones, methods, and classes. The holy trinity of "why does this parcel cost that much."

Tool	Method	What It Does
`fluentcart_shipping_zone_list`	GET	List all shipping zones with methods and regions
`fluentcart_shipping_zone_get`	GET	Get a specific shipping zone
`fluentcart_shipping_zone_create`	POST	Create a new shipping zone
`fluentcart_shipping_zone_update`	PUT	Update a shipping zone
`fluentcart_shipping_zone_delete`	DELETE	Delete a shipping zone
`fluentcart_shipping_zone_reorder`	POST	Reorder shipping zones by priority
`fluentcart_shipping_zone_states`	GET	Get available states/regions for zones
`fluentcart_shipping_method_create`	POST	Add a shipping method to a zone
`fluentcart_shipping_method_update`	PUT	Update a shipping method
`fluentcart_shipping_method_delete`	DELETE	Delete a shipping method
`fluentcart_shipping_class_list`	GET	List all shipping classes
`fluentcart_shipping_class_get`	GET	Get a specific shipping class
`fluentcart_shipping_class_create`	POST	Create a shipping class
`fluentcart_shipping_class_update`	PUT	Update a shipping class
`fluentcart_shipping_class_delete`	DELETE	Delete a shipping class

Classes, rates, EU VAT, and tax records. Everything your accountant wishes you'd sorted out months ago.

Tool	Method	What It Does
`fluentcart_tax_class_list`	GET	List all tax classes
`fluentcart_tax_class_create`	POST	Create a new tax class
`fluentcart_tax_class_update`	PUT	Update a tax class
`fluentcart_tax_class_delete`	DELETE	Delete a tax class
`fluentcart_tax_rate_list`	GET	List all tax rates across countries
`fluentcart_tax_rate_country`	GET	Get tax rates for a specific country
`fluentcart_tax_rate_create`	POST	Create a tax rate for a country
`fluentcart_tax_rate_update`	PUT	Update a tax rate
`fluentcart_tax_rate_delete`	DELETE	Delete a tax rate
`fluentcart_tax_country_delete_all`	DELETE	Delete all tax rates for a country
`fluentcart_tax_country_id_get`	GET	Get country tax ID settings (VAT number)
`fluentcart_tax_country_id_save`	POST	Save country tax ID settings
`fluentcart_tax_shipping_override_create`	POST	Create a shipping tax override
`fluentcart_tax_shipping_override_delete`	DELETE	Delete a shipping tax override
`fluentcart_tax_config_rates`	GET	Get tax configuration with rate overviews
`fluentcart_tax_config_countries_save`	POST	Save countries configured for tax
`fluentcart_tax_settings_get`	GET	Get global tax settings
`fluentcart_tax_settings_save`	POST	Save global tax settings
`fluentcart_tax_eu_vat_save`	POST	Save EU VAT configuration
`fluentcart_tax_eu_rates`	GET	Get EU VAT rates for all member states
`fluentcart_tax_records_list`	GET	List tax records for reporting
`fluentcart_tax_records_mark_filed`	POST	Mark tax records as filed

Templates and settings for every transactional email. Customise them, preview them, toggle them off when you've had enough.

Tool	Method	What It Does
`fluentcart_email_list`	GET	List all email notification templates
`fluentcart_email_get`	GET	Get a specific email template
`fluentcart_email_update`	PUT	Update an email template
`fluentcart_email_toggle`	POST	Enable or disable a notification
`fluentcart_email_shortcodes`	GET	Get available template shortcodes
`fluentcart_email_template_preview`	POST	Preview a rendered email template
`fluentcart_email_settings_get`	GET	Get global email settings
`fluentcart_email_settings_save`	POST	Save global email settings

Access control. Decide who gets to touch what — and who absolutely shouldn't.

Tool	Method	What It Does
`fluentcart_role_list`	GET	List all roles with capabilities
`fluentcart_role_get`	GET	Get a specific role
`fluentcart_role_create`	POST	Create a custom role
`fluentcart_role_update`	POST	Update a role
`fluentcart_role_delete`	DELETE	Delete a custom role
`fluentcart_role_managers`	GET	List users with management roles
`fluentcart_role_user_list`	GET	List all users with their roles

Upload, list, and delete files. Riveting stuff.

Tool	Method	What It Does
`fluentcart_file_list`	GET	List uploaded files
`fluentcart_file_upload`	POST	Upload a file
`fluentcart_file_bucket_list`	GET	List file storage buckets
`fluentcart_file_delete`	DELETE	Delete a file

Store config, payment methods, modules, permissions, and print templates.

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_save_payment_method`	POST	Save specific payment method settings
`fluentcart_settings_reorder_payment_methods`	POST	Set display order of payment methods
`fluentcart_settings_get_modules`	GET	Get module settings
`fluentcart_settings_save_modules`	POST	Save module activation and configuration
`fluentcart_settings_get_permissions`	GET	Get permissions
`fluentcart_settings_save_permissions`	POST	Save permissions
`fluentcart_settings_get_confirmation_shortcodes`	GET	Get confirmation page shortcodes
`fluentcart_settings_save_confirmation`	POST	Save order confirmation page settings
`fluentcart_settings_print_templates_get`	GET	Get print templates (invoices, packing slips)
`fluentcart_settings_print_templates_save`	PUT	Update print templates

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)	55	Full catalogue management
Customers	19	Profiles, addresses, stats
Subscriptions	7	Lifecycle management
Coupons	12	Discounts and promotions
Reports (Core + Insights)	45	Analytics and metrics
Shipping	15	Zones, methods, classes
Tax	22	Rates, EU VAT, records
Email Notifications	8	Templates and settings
Order Bumps	5	Upsell offers
Product Options	10	Attributes and terms
Integrations	12	Third-party addons
Settings	14	Store configuration
Roles & Permissions	7	Access control
Labels	3	Order tags
Activity	3	Audit log
Notes	1	Order annotations
Dashboard	2	Overview stats
Application	4	App info
Files	4	File management
Public	4	Public-facing
Miscellaneous	4	Utilities
Total (static mode)	274
Total (dynamic mode)	3	Meta-tools that proxy to all 274

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.

Response transforms and in-memory caching keep token usage tight. Static reference data is cached with TTL, and heavy list responses are trimmed before they reach the AI.

MCP Resources

Four read-only resources for reference data. These are browsable context the AI can read without calling tools — useful for grounding conversations with store configuration:

Resource URI	Description
`fluentcart://store/config`	Store settings and configuration (currency, locale, modules)
`fluentcart://store/countries`	Supported countries and their details
`fluentcart://store/payment-methods`	Configured payment methods
`fluentcart://store/filter-options`	Available filter options for orders, products, customers

Resources are application-controlled — the client decides when to read them. Static data is cached in-memory, so repeated reads don't hit the API.

MCP Prompts

Five pre-built workflows that guide the AI through multi-step operations. Think of them as recipes — the AI knows which tools to call and in what order:

Prompt	Arguments	What It Does
`analyze-store-performance`	`startDate`, `endDate`	Revenue overview, KPIs, and best sellers for a date range
`investigate-order`	`order_id`	Deep-dive into order details, transactions, and activity timeline
`customer-overview`	`customer_id`	Full customer profile with stats, addresses, and spending history
`catalog-summary`	(none)	Catalog health report — product count, top sellers, store metrics
`subscription-health`	`startDate`, `endDate`	Subscription churn, renewal success, and revenue forecast

Not all MCP clients support prompts yet. Claude Desktop and Claude Code do. If yours doesn't, just ask for the same thing in plain English — the AI will figure out the same tool sequence on its own.

Response Caching

Static reference data is cached in-memory so the AI doesn't re-fetch the same 250-country list every time it needs to validate an address:

Endpoint	Cache TTL
Countries list	1 hour
Filter options	10 minutes
App init (store config)	10 minutes
Report metadata	10 minutes

The cache lives in the server process. Restart the server to clear it. No external dependencies, no Redis, no drama.

Tool Reference

Dynamic Mode

Tool Annotations

Orders — Core (15 tools)

Orders — Transactions (8 tools)

Products — Core (16 tools)

Products — Pricing (12 tools)

Products — Variants (9 tools)

Products — Catalogue (18 tools)

Customers (19 tools)

Subscriptions (7 tools)

Coupons (12 tools)

Reports — Core (24 tools)

Reports — Insights (21 tools)

Order Bumps (5 tools)

Product Options (10 tools)

Integrations (12 tools)

Shipping (15 tools)

Tax (22 tools)

Email Notifications (8 tools)

Roles & Permissions (7 tools)

Files (4 tools)

Settings (14 tools)

Labels (3 tools)

Activity (3 tools)

Notes (1 tool)

Dashboard (2 tools)

Application (4 tools)

Public (4 tools)

Miscellaneous (4 tools)

The Numbers

MCP Resources

MCP Prompts

Response Caching

On this page