MCP Tool Reference

Atualizado em 13 de outubro de 2026

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

How to Read the Reference#

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.

Which Tool Returns What#

Nível de detalheEscopoNível de tempo
Ferramentatotallojaconta de anúncioscampanhaconjunto de anúnciosanúnciocanalpaísprodutopedidoitem do pedidodespesaregra de fretealteração sugeridaintegraçãoimportaçãoguiafeedbackcontalojavisualização combinadatotal do períodopor diaperíodo anteriormomento atualregistro de alterações
Configuração
list_shops
list_views
get_shop_details
get_skill
Lucro
get_profit_summary
get_profit_by_day
get_profit_by_product
get_product_profit_by_day
Anúncios e atribuição
get_ad_spend
get_ad_spend_by_campaign
get_ad_spend_by_day
get_campaign_spend_by_day
get_ad_performance
get_campaign_history
get_attribution_report
Países
get_country_breakdown
get_country_detail
Pedidos e despesas
list_orders
get_order
list_expenses
Custos de produto e frete
get_cost_apply_state
list_shipping_rules
list_product_costs
propose_shipping_rule_changes
propose_product_cost_changes
get_change_request
Atualização dos dados
get_integration_status
list_tasks
trigger_refresh
Feedback
give_feedback

All Tools#

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.

Configuração

Lucro

Anúncios e atribuição

Países

Pedidos e despesas

Custos de produto e frete

Atualização dos dados

Feedback

Tools That Propose Changes#

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.

Perguntas frequentes

Artigos relacionados

Este artigo foi útil?

Valorizamos sua privacidade
Usamos cookies para melhorar sua experiência. Ao continuar usando nosso site, você concorda com o uso de cookies.

Ao clicar em "Aceitar tudo", você concorda com o uso de cookies.

Saiba mais