When you connect Claude, ChatGPT or another assistant to Profitario, it answers your questions by calling tools. This article lists every tool: what it is for, the parameters the assistant can set and every field it gets back. You never call a tool yourself; it helps to know what exists when a question gets a partial answer.
Where In your AI assistant, once it is connected under Settings → MCP
Who The account owner connects the assistant
Updates Every tool reads your live data, the same data the dashboard shows Each tool returns data at a fixed level of detail:
Entity grain : what one row is, from a whole store down to a single ad, order line or expense.Scope : whether a tool reads the whole account, one store, or a dashboard view that combines several stores.Time grain : totals for the date range, one row per day, a point-in-time state, or a log of changes.
Dates are days in your store's timezone. Money is in the store currency, or in the view currency for a combined view; attributed revenue stays in each store's own currency.
Pick a question to see the tools that answer it, or search for a field such as roas or cogs. Open a tool for its parameters and returned fields.
Which stores can it see?4 tools
Connected stores, combined views, store settings and the usage guide
How profitable am I?4 tools
Revenue, costs and net profit for any period, per day and per product
Are my ads paying off?7 tools
Spend, ROAS and CPA from ad account down to single ads, and the orders each campaign gets credit for
Where do my customers buy?2 tools
Orders, costs, ad spend and profit for every country you sell to
What happened with an order?3 tools
Single orders with every cost, fee and refund, and your custom expenses
Are my costs set up right?6 tools
Product costs and shipping rules, and suggested changes that a person approves in Profitario
Is my data up to date?3 tools
Sync health, running imports and a refresh
Missing something?1 tool
A wish or a missing capability, sent straight to the Profitario team
Search 30 tools and their fields
Setup
Shops list_shopsYour connected stores with currency and timezone. Dashboard views list_viewsYour dashboard views that combine several stores. Shop details get_shop_detailsA store's currency, timezone and reporting settings. Usage guide get_skillThe guide the assistant reads to pick tools and apply Profitario's formulas. Profit
Profit summary get_profit_summaryRevenue, every cost, ad spend, expenses and net profit for a period, as on the dashboard. Profit by day get_profit_by_dayThe dashboard's metrics, one row per day, for trends, spikes and dips. Profit by product get_profit_by_productProducts ranked by sales, with product costs, gross profit, margin, units, refunds and stock. Product profit by day get_product_profit_by_dayProduct sales, costs and gross profit day by day, for up to 31 days or a single product. Ads and attribution
Ad spend by account get_ad_spendSpend, clicks and ROAS per connected ad account, and when each account last synced. Ad spend by campaign get_ad_spend_by_campaignThe Ad Spend report's campaign table and KPI tiles, optionally against the previous period. Ad spend by day get_ad_spend_by_dayDaily spend, clicks and costs per click for each ad account, for up to 92 days. Campaign spend by day get_campaign_spend_by_dayOne row per campaign and day with spend, ROAS and credited revenue, like the Ad Spend report export. Ad set and ad performance get_ad_performanceSpend, ROAS and frequency for each ad set or single ad, next to the orders Profitario credits to it. Campaign change history get_campaign_historyEvery budget and status change on your campaigns, ad sets and ads, day by day. Attribution report get_attribution_reportOrders and revenue credited to each campaign and channel, including new customers and contribution margin. Countries
Profit by country get_country_breakdownOrders, revenue, costs, ad spend and profit per country, as in the Countries report. Country detail get_country_detailOne country in depth: its daily trend, top products and the campaigns credited with its orders. Orders and expenses
Order search list_ordersSearch orders by number, date, country, product or payment status, with profit and costs per order. Order detail get_orderOne order with its line items, costs, fees, refunds and payment transactions. Expenses list_expensesYour custom expenses, per store or account-wide, with amounts and billing cycles. Product costs and shipping
Cost recalculation status get_cost_apply_stateWhether cost recalculations are running or stuck, with the number of rules and costs per area. Shipping rules list_shipping_rulesYour shipping cost rules, in the order Profitario checks them. Product costs list_product_costsUnit and handling cost per variant, with quantity breaks, the cost source and the Shopify cost. Suggest shipping rule changes propose_shipping_rule_changesSuggests new, changed or deleted shipping rules, with their impact on the last 90 days. Proposes changes Suggest product cost changes propose_product_cost_changesSuggests product costs, quantity breaks or dated price changes for up to 20 products. Proposes changes Suggestion status get_change_requestWhether a suggested change is waiting, approved, rejected, outdated or expired. Data freshness
Integration health get_integration_statusHealth of every connected integration, problems first, with recent sync runs on request. Running imports list_tasksImports and syncs that are running or finished in the last day. Refresh data trigger_refreshThe dashboard's Refresh button: fetches fresh ad, analytics and Shopify data. Feedback
Send feedback give_feedbackPasses a wish or a missing capability straight to the Profitario team. Tools marked Proposes changes suggest new product costs or shipping rules. They never save anything themselves: each suggestion opens a review page in Profitario, and nothing changes until a person approves it there. A suggestion that is not approved within 24 hours expires.
The assistant can only make these suggestions for the stores and areas you allowed when you connected it. With read access only, these tools refuse and the assistant tells you so.
Can I call a tool myself?
Why does the assistant not know something the dashboard shows?
Do the numbers match my dashboard?
