trueprofit_skill

Overview

This skill is the TrueProfit profit analytics expert for merchants using the TrueProfit MCP platform. It helps analyze store performance, profit, ROAS, COGS, orders, ad spend, shipping and customer metrics across connected shops. Trigger it automatically for any e-commerce analytics question involving a TrueProfit store or when connecting a new MCP server.

How this skill works

The skill maps user questions to the correct MCP tool (profit summaries, profit by date/product, orders, ad costs, customers, shipping, etc.) and guides API calls using the shop_id and date range patterns required by TrueProfit. It enforces key checks — shop context, timezone-aware date ranges, COGS completeness, and platform connection status — and returns the most actionable metrics and diagnostics. It also recommends the exact calls and parameters to run (list_shops, get_profit_summary, list_orders, update_product_cogs, get_ad_costs, etc.).

When to use it

• Ask about profit, net margin, gross profit, or contribution margin for a shop.
• Request ROAS, blended ROAS, MER, or ad spend breakdown by platform or UTM.
• Investigate orders, refunds, shipping costs, or search for a specific order number.
• Compare shops, run multi-shop profit comparisons, or confirm shop currency/timezone before analysis.
• Update or validate product COGS and understand retroactive profit recalculation.

Best practices

• Always start by calling list_shops and confirm shop_id before any analysis.
• Use YYYY-MM-DD date ranges in the shop’s local timezone; check get_shop_details if precision matters.
• Warn users when products have COGS = 0 — profit is unreliable until costs are set.
• For order-level shipping costs, collect up to 100 order IDs via list_orders, then call get_shipping_cost.
• Sort product performance by net profit (not revenue) and flag high-volume low-margin items.
• Confirm currency before comparing shops or aggregating across stores; don’t mix currencies without conversion.

Example use cases

• "What was my net profit and ROAS last month?" → list_shops → get_profit_summary → get_ad_costs.
• "Which products delivered the highest net profit in the last 30 days?" → get_profit_by_product, sort by net profit, flag COGS=0.
• "Find order #1234 and show full order insights" → list_orders with search="#1234" → get_order_insights.
• "My profit dropped this week — why?" → get_profit_by_date, get_ad_costs, list_orders filtered by refunded status.
• "Set or bulk-update COGS for a product catalog" → list_products → update_product_cogs (variant_id=0 for all variants) → get_product to verify.