admin_get_analytics
ChatGPTRetrieve raw numerical sales aggregates—order count, revenue, and average order value—for a date range. Use when the user requests metrics or exact numbers without a narrative summary. For a merchant-friendly recap, use sales_summary; for comparing two periods, use sales_comparison.
admin_get_customer
ChatGPTRetrieve a registered Magento customer using their exact email address. Use when the user requests the customer's account details. Do not use to retrieve their orders or create or update their account.
admin_get_customer_orders
ChatGPTList Magento orders associated with an exact customer email address. Use when the user asks for a customer's orders or purchase history as an order list. For a combined customer profile and order summary, use customer_order_summary.
admin_get_inventory
ChatGPTRetrieve the current stock quantity and in-stock status for one exact product SKU. Use when the user asks about inventory for a specific SKU. Do not use to discover or list multiple low-stock or out-of-stock products.
admin_get_order
ChatGPTRetrieve one Magento sales order by its exact human-readable increment ID. Return its available order details, including status, totals, line items, and customer email. Use for direct order-detail lookups. Do not use for shipment tracking or a multi-source order investigation.
admin_get_order_tracking
ChatGPTRetrieve all shipment tracking numbers associated with one Magento order increment ID. Use when the user asks for tracking numbers or shipment tracking references. Do not use as a substitute for retrieving full shipment details.
admin_get_product
ChatGPTRetrieve back-office catalog details for one exact SKU, including product status, pricing, attributes, and available admin-side fields. Use for administrative product details. For storefront-visible product information, use customer_get_product; for product discovery by name or SKU, use admin_search_products.
admin_get_product_attribute
ChatGPTRetrieve Magento product attribute metadata and available options for an exact attribute code, such as color or size. Use for questions about attribute definitions, selectable values, or attribute configuration—not to retrieve a product's actual attribute value.
admin_get_product_sales
ChatGPTRetrieve sales quantity and revenue grouped or ranked by product SKU for a date range, optionally restricted to one SKU. Use for product-level sales performance, units sold, or revenue by SKU. For a best-selling product list, use best_selling_products.
admin_get_shipment
ChatGPTRetrieve shipment details for a known shipment increment ID. Use for details about one shipment. For shipment discovery by order, use admin_search_shipments.
admin_get_store_hierarchy
ChatGPTRetrieve the Magento website → store group → store view hierarchy, optionally filtered by website code. Use when the user asks about website codes, store groups, store views, or how the store is structured. Do not use for sales or product information.
admin_search_inventory
ChatGPTSearch inventory records using general criteria such as SKU, product name, quantity, and in-stock status. Use for targeted inventory searches or combinations of filters. Do not use for general requests to find low-stock products or products that are out of stock; use the corresponding dedicated discovery tool.
admin_search_orders
ChatGPTSearch Magento sales orders by status and/or customer email. Use to list orders matching these filters. For details about one known order, use admin_get_order; for a broader diagnostic investigation, use investigate_order.
admin_search_products
ChatGPTSearch the Magento admin catalog by product name or SKU. Use when the user wants to find products in the catalog or identify matching SKUs for administrative or merchandising work. For storefront-visible product discovery, use customer_search_products.
admin_search_shipments
ChatGPTSearch Magento shipments by order increment ID. Use when the user wants to find shipments associated with an order. For tracking numbers, use admin_get_order_tracking; for details of one known shipment, use admin_get_shipment.
analyze_catalog
ChatGPTAnalyze a paginated set of Magento catalog products, optionally using metadata for a specified attribute. Use for catalog-wide analysis or identifying product data patterns. Do not use for a simple product lookup or dedicated missing-data checks.
best_selling_products
ChatGPTReturn a ranked list of best-selling Magento products over a date range, optionally enriched with product details. Use when the user asks for top sellers, best-selling products, or products ranked by sales. Do not use for low-stock discovery or restocking decisions that specifically require a combined stock-and-demand ranking.
customer_create_cart
ChatGPTCreate a new guest shopping cart. Use only when the user explicitly requests starting or creating a shopping cart. This operation changes store state and requires confirm=true. Do not invoke for questions about cart functionality.
customer_get_product
ChatGPTRetrieve storefront-facing product information for one exact SKU, such as its displayed name, price, description, and images. Use when the user asks what a shopper sees for a particular product. For admin-only attributes or inventory fields, use admin_get_product or the appropriate inventory tool.
customer_order_summary
ChatGPTSummarize a customer's profile and order history using their exact email address. Use when the user asks for a customer purchase-history summary or an overview of a customer's activity, rather than a raw list of orders.
customer_search_products
ChatGPTSearch products available through the Magento storefront using a product name, SKU, or descriptive query. Use for shopper-facing product discovery and browsing. Do not use for admin-only catalog data, detailed attribute metadata, or inventory searches.
daily_store_summary
ChatGPTSummarize Magento store operations for one calendar day. Use when the user asks for today's summary, a daily report, or what happened on a particular day. Do not use for multi-day comparisons.
find_low_stock_products
ChatGPTFind and list in-stock Magento products whose quantity is at or below a specified threshold; default threshold is 5. Use whenever the primary intent is to identify low-stock products, products running low, or products with quantity less than or equal to a limit. Do not use for a single-SKU lookup, general inventory filtering, or restocking prioritization based on sales.
find_orders_needing_attention
ChatGPTIdentify Magento orders that may require operational follow-up based on status, payment, and shipment signals. Use when the user asks which orders are delayed, problematic, stuck, or need attention. For a specific order investigation, use investigate_order.
find_out_of_stock_products
ChatGPTFind and list Magento products that are currently out of stock. Use when the user asks which products are out of stock, unavailable due to stock, or have no available inventory. Do not substitute a general inventory search.
find_products_needing_updates
ChatGPTIdentify catalog products with missing or incomplete data, such as empty names, zero prices, or disabled status. Use when the user asks which products need catalog cleanup or updates. Do not use for ordinary product search or inventory checks.
find_restock_candidates
ChatGPTIdentify and rank products for potential restocking by combining stock quantities with sales demand over a date range. Use when the user asks what to restock, which products should be replenished first, or which low-stock products have sales demand. Do not use for a simple low-stock list without prioritization.
investigate_order
ChatGPTPerform a multi-source investigation of one Magento order using its exact increment ID, gathering relevant order, customer, product, inventory, shipment, and tracking information to diagnose issues. Use when the user asks to investigate, troubleshoot, or explain a specific order problem—not for a simple order-detail or tracking lookup.
sales_comparison
ChatGPTCompare sales metrics across two explicitly specified date ranges. Use when the user asks whether sales, revenue, order count, or average order value increased or decreased between periods. Do not use for a single-period summary.
sales_summary
ChatGPTGenerate a merchant-friendly sales summary, including key metrics and a written overview for a date range. Use for questions such as “How did sales perform?” or “Summarize this month's sales.” For raw metrics only, use admin_get_analytics; for two-period comparisons, use sales_comparison.
store_overview
ChatGPTGet a high-level overview of the Magento store, combining sales analytics, recent orders, catalog, inventory, and store hierarchy. Use when the user asks for an overall store overview, health check, or general status. Do not use for a question limited to one specific metric or entity.
