Lusca

Use this when the user asks for the variants, price, stock, or status of one known Shopify product identified by title, handle, or SKU. Use list_products to browse or filter multiple products.

get_product

Use this when the user asks why one known Google Ads campaign, especially Performance Max, can or cannot deliver. Returns campaign and asset-group status, eligibility reasons, and budget without changing Ads.

get_pmax_diagnostic

Use this when the user explicitly asks to test, verify, validate or troubleshoot the complete Lusca installation with live provider requests. Do not use this merely to answer whether everything is connected, linked, disconnected or incomplete; use get_onboarding_status for connection-state questions. It checks the MCP server, active workspace and every connected Shopify, Merchant Center, Google Ads, Search Console and GA4 source with real read-only requests; it may refresh only Lusca's local caches and never creates, approves or applies provider changes.

run_installation_diagnostic

Use this when the user asks how organic Google Search clicks, impressions, CTR, or position changed over time. Returns a daily Search Console series, read-only.

get_gsc_performance_by_date

Use this when the user asks how Shopify orders or net payments after refunds changed over time within the last 60 days. Returns a complete daily, read-only series in the store time zone with explicit currency; older history is refused because Lusca has read_orders, not read_all_orders.

get_shopify_sales_timeline

Use this when the user asks to read the audit trail or history of Shopify and Google Ads change approvals, rejections, failures, or validations. This tool never creates, approves, rejects, or applies a change; continue with next_offset when has_more is true.

list_change_reviews

Use this when the user asks for the active Lusca store identity, domain, currency, known catalog size, or last Shopify catalog synchronization. Use list_stores to discover every accessible workspace.

get_shop_info

Use this when the user asks which Lusca stores, sites, or workspaces their connected account can access, or before switching the active store. Do not use this to list Shopify products.

list_stores

Use this when the user asks to list, browse, search, or filter multiple Shopify products, variants, prices, stock levels, or statuses, including requests such as 'show five products'. Use get_product for one known product, handle, or SKU.

list_products

Use this when the user asks for Merchant Center offer details such as approval, price, availability, product URL, destination status, or issue resolution. Returns every destination reported by Merchant Center with its status and available approved, pending, or disapproved country lists. Reads a fresh cached snapshot and never changes Google.

get_merchant_offers

Use this when the user asks for Google Ads spend, impressions, clicks, conversions, conversion value, or ROAS by campaign over a date range. Use get_ads_overview for account configuration plus a daily trend.

get_ads_performance

Use this when the user asks about GA4 traffic, users, engaged sessions, engagement rate, average session duration, key events, purchase revenue, acquisition channels, or landing pages. Returns exact read-only totals plus a paginated breakdown.

get_ga4_performance

Use this when the user asks to verify that the installed Lusca connector is reachable, responsive, or running the expected version. It checks only the Lusca MCP server, not Shopify or Google provider data, and changes nothing.

ping

Use this when the user asks for a broad, cross-source, read-only audit of the connected store or the single biggest issue affecting revenue. For a request limited to the single biggest or most important revenue issue, call this first and stop after its result unless one focused follow-up is strictly needed to support the selected priority; never fan out across multiple connectors in that turn. Use broader multi-tool drill-downs only when the user explicitly asks for a comprehensive or detailed audit across multiple named sources or dimensions. It refreshes Lusca's Shopify and Merchant caches when possible and never changes provider data.

get_store_audit

Use this when the user asks for a prioritized catalog-wide list of product recommendations or diagnostic actions. Use get_product_labels for raw product signals or a single-product investigation.

list_recommendations

Use this when the user asks which products or offers are blocked, rejected, disapproved, or ineligible for paid Google Shopping or Performance Max. Use get_feed_health for the aggregate feed audit and get_free_listings_visibility for organic Free Listings.

list_blocked_products

Use this when the user asks to compare one existing Google Ads campaign over 48 hours versus the previous 48 hours, seven days versus the previous seven days, or both. It refuses unknown campaign IDs and is read-only.

get_campaign_report

Use this when the user asks for the complete latest Lusca daily report across connected ecommerce sources, or explicitly asks to regenerate that report. It never performs a business mutation.

get_daily_report

Reserve au composant UI : enregistre le rejet d'une demande apres le clic Rejeter de l'utilisateur. N'execute aucune operation.

reject_ads_change

Reserve au composant UI (bouton 'Reverifier') : relit l'etat reel d'une campagne et de ses asset groups et retourne le verdict de diffusion. Lecture seule.

recheck_ads_status

Use this when the user asks for aggregate Merchant Center feed health or paid Shopping and Performance Max launch readiness. It adds Shopify price, availability, and missing-product comparisons when Shopify is connected; use list_blocked_products for the blocking product list.

get_feed_health

Use this when the user asks for raw deterministic diagnostic signals per Shopify product, optionally enriched by Merchant Center and Search Console. Use list_recommendations for a prioritized catalog-wide action list.

get_product_labels

Use this when the user asks for Shopify order count, net payments after refunds, net average order value, or top product quantities over a date range within the last 60 days. Do not use this for GA4 revenue.

get_store_stats

Use this when the user asks whether everything is connected in Lusca, or which Shopify or Google connectors are connected, disconnected, incomplete, or linked to the active store. It reports configured linkage state only and does not test provider functionality with live requests. Use run_installation_diagnostic only when the user explicitly asks for functional provider tests. Use get_connector_capabilities for the complete installed tool manifest.

get_onboarding_status

Use this when the user explicitly asks to force-refresh or resynchronize Merchant Center offers before an analysis, and only then. It reads Google Merchant Center and updates only Lusca's internal cache; it never changes Google.

sync_merchant

Use this when the user explicitly asks to force-refresh or resynchronize the Shopify products and variants cache before an analysis, and only then. It reads Shopify and updates only Lusca's internal cache; it never changes Shopify.

sync_products

Use this when the user asks whether products are eligible for or actually observed in organic Google Shopping Free Listings. It separates current country-level eligibility from observed organic impressions and never treats zero impressions as proof of invisibility.

get_free_listings_visibility

Use this when the user asks for a consolidated Google Ads account view: currency, time zone, campaign delivery, budgets, performance totals, and daily trend. Read-only.

get_ads_overview