TrueProfit

Get 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_order_insights

Get a summary of orders for a date range, including totals for revenue, COGS, shipping, and profit.

get_orders_summary

Get detailed information about a specific product by ID, including all variants, COGS, pricing, and inventory data.

get_product

Get 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_profit_summary

Get 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_by_date

Get 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_report_config

Get revenue attributed to each UTM source for a date range, as a daily series per source. Attribution is first-click: the source of the customer's first recorded visit, normalised to a canonical name, so paid and organic traffic from the same platform share one bucket. Sources only: no medium, campaign or utm_content dimension, and no order count. For per-campaign or per-ad figures, and to separate paid from organic, use get_marketing_attribution with level=campaign.

get_revenue_by_utm

Get shipping cost for specific orders. Pass order IDs to retrieve the shipping costs that were calculated for each order.

get_shipping_cost

Get details of the current shop including domain, currency, timezone, plan, and platform info

get_shop_details

Get sales channels configured for the shop. Shows which sales channels (Online Store, POS, etc.) are active.

get_store_channels

Get payment gateways configured for the shop. Shows which payment processors are active and their transaction fee settings.

get_store_gateways

Get transaction insights and analytics. Returns aggregated custom cost trends and category breakdowns.

get_transaction_insights

Get the TrueProfit SKILL.md file with installation instructions and best practices for using TrueProfit MCP tools.

get_skill

List 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_blog_posts

List custom metrics defined by the merchant. Shows user-defined KPIs and calculated fields used in profit reports.

list_custom_metrics

List 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_orders

List 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_products

List all shops the authenticated user has access to

list_shops

List 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.

list_transactions

Submit 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.

submit_feedback