get_ad_costs
ChatGPTGet advertising cost summary for a date range from the profit dashboard. Returns ad spend breakdown as part of the overall profit overview. To see connected platforms, use get_connected_platforms first.
get_all_shop_insights
ChatGPTGet a combined profit overview across ALL shops the user has access to. Returns aggregated revenue, costs, net profit, and margin for all shops in one call. Useful for merchants managing multiple stores.
get_blog_post
ChatGPTFetch and read the text content of a TrueProfit blog post by its URL. Returns the readable text of the article, suitable for summarizing or analyzing the content. Only accepts URLs under https://trueprofit.io/blog/.
get_cac_metrics
ChatGPTGet Customer Acquisition Cost (CAC) metrics based on custom spend categories. Shows how much it costs to acquire a customer through different spend channels.
get_cogs_return
ChatGPTGet COGS return analysis for a date range. Shows cost of goods sold returns and their impact on profit.
get_connected_platforms
ChatGPTGet all connected ad platforms (Facebook, Google, TikTok, etc.) for the current shop
get_current_user
ChatGPTGet the currently authenticated user's email, role, and shop
get_custom_costs
ChatGPTGet custom costs/spend for a date range. Returns custom cost categories and their values.
get_customer_overview
ChatGPTGet customer overview statistics for the current shop, including total customers, new customers count, and other customer metrics.
get_order_insights
ChatGPTGet detailed profit insights for a specific order by its Shopify order ID, including line items with individual COGS, shipping costs, handling fees, and profit breakdown.
get_orders_summary
ChatGPTGet a summary of orders for a date range, including totals for revenue, COGS, shipping, and profit.
get_product
ChatGPTGet detailed information about a specific product by ID, including all variants, COGS, pricing, and inventory data.
get_profit_by_date
ChatGPTGet daily profit breakdown within a date range as chart data. Returns per-day: revenue, cost breakdown, net profit, margin, and order count. Useful for trend analysis and identifying profitable/unprofitable days.
get_profit_summary
ChatGPTGet a profit summary for the current shop within a date range. Returns: revenue, COGS, shipping costs, ad costs, transaction fees, custom costs, discounts, taxes, refunds, net profit, and profit margin. Also includes a comparison with the previous period if available.
get_report_config
ChatGPTGet the shop's profit report configuration. Shows which cost components are included/excluded in profit calculations (e.g., whether shipping, taxes, discounts are factored in).
get_revenue_by_utm
ChatGPTGet revenue breakdown by UTM source/medium/campaign for a date range. Useful for analyzing marketing channel performance.
get_shipping_cost
ChatGPTGet shipping cost for specific orders. Pass order IDs to retrieve the shipping costs that were calculated for each order.
get_shop_details
ChatGPTGet details of the current shop including domain, currency, timezone, plan, and platform info
get_skill
ChatGPTGet the TrueProfit SKILL.md file with installation instructions and best practices for using TrueProfit MCP tools.
get_store_channels
ChatGPTGet sales channels configured for the shop. Shows which sales channels (Online Store, POS, etc.) are active.
get_store_gateways
ChatGPTGet payment gateways configured for the shop. Shows which payment processors are active and their transaction fee settings.
get_transaction_insights
ChatGPTGet transaction insights and analytics. Returns aggregated custom cost trends and category breakdowns.
list_blog_posts
ChatGPTList all TrueProfit blog posts from the sitemap at trueprofit.io/blog. Returns each post URL and last modified date. Use this to discover new or recently updated articles. Note: only returns English posts; does not include category pages or localized variants.
list_custom_metrics
ChatGPTList custom metrics defined by the merchant. Shows user-defined KPIs and calculated fields used in profit reports.
list_orders
ChatGPTList orders for the current shop within a date range. Returns order ID, name, financial status, created date, total price, profit, margin, COGS, shipping cost, discounts, tax, and transaction fees. Supports pagination and filtering by financial status.
list_products
ChatGPTList products for the current shop. Returns product ID, title, variants with SKU, COGS (cost of goods sold), and pricing information. Supports search and pagination.
list_shops
ChatGPTList all shops the authenticated user has access to
list_transactions
ChatGPTList custom transactions (manually added expenses) for a date range. Returns custom cost entries that merchants have logged, such as packaging, software subscriptions, or other business expenses.
submit_feedback
ChatGPTSubmit feedback about TrueProfit — bug reports, feature requests, questions, or general comments. Your feedback goes directly to the TrueProfit product team. IMPORTANT: For bug reports and errors (category=bug), you MUST include reproduce_steps — a step-by-step account of what the user did leading up to the issue, including which MCP tools were called, their parameters, and the error responses. This context is critical for debugging.