Ferramentas MCP

Esta lista é gerada no build a partir do catálogo do servidor (o mesmo que tools/list publica) e dos schemas de entrada de cada ferramenta. As descrições ficam em inglês, como o assistente as recebe.

Comece por list_stores: os ids de loja que ela devolve são o único identificador de loja que as outras ferramentas aceitam. Para conectar um assistente, veja Conectar um assistente de IA.

Ferramenta	O que faz	Tipo
list_stores	List stores	leitura
describe_metrics	Describe available metrics	leitura
get_metrics	Get attendance metrics	leitura
list_ad_campaigns	List ad campaigns	leitura
get_ad_campaign	Get an ad campaign	leitura
get_ads_performance	Get ads performance	leitura
list_ad_groups	List ad groups	leitura
list_ad_advertisers	List ad advertiser accounts	leitura
list_opportunities	List Ads opportunities	leitura
get_opportunity	Get an Ads opportunity	leitura
update_ad_campaign	Update an ad campaign	escrita
set_ad_group_status	Set ad group status	escrita
apply_opportunity	Apply an Ads opportunity	escrita
apply_opportunities	Apply several Ads opportunities	escrita
dismiss_opportunity	Dismiss or flag an Ads opportunity	escrita

list_stores

List stores leitura

List the merchant's stores with their opaque identifiers. Call this first: every other tool that filters or reports by store uses these ids, and no other identifier is accepted. Ads coverage in this version is Mercado Livre only.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Filter by marketplace. Omit for every store. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok

describe_metrics

Describe available metrics leitura

Explain the attendance-metric dictionary this API serves: which conversation scopes exist, which metric ids each scope publishes, their type, unit and aggregation, and which granularities and breakdown dimensions get_metrics accepts. Call this before get_metrics when you are unsure which metric id or scope key to ask for. The invariant pending + resolved = total holds in every scope.

Sem parâmetros.

get_metrics

Get attendance metrics leitura

Attendance metrics for a period, optionally broken down by day, week or month and by store. Accepts either a relative period (period="last_7_days") or an explicit start_date and end_date; give one or the other, never both. The window may not exceed 90 days. Metric ids and scope keys come from describe_metrics; an unavailable metric is absent from a row, never zero.

Parâmetro	Tipo	Obrigatório	Descrição
period	string	não	Relative window, resolved on the server in 'timezone'. Mutually exclusive with start_date/end_date. Defaults to last_30_days when neither is given. Valores: today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, month_to_date, last_month
start_date	string (date)	não	Inclusive ISO 8601 date (YYYY-MM-DD). Give it together with end_date.
end_date	string (date)	não	Inclusive ISO 8601 date (YYYY-MM-DD). Must not be in the future.
timezone	string	não	IANA time zone used for day boundaries, e.g. America/Sao_Paulo. Padrão: "UTC"
granularity	string	não	Valores: day, week, month, total Padrão: "day"
scopes	string[]	não	Omit for every scope describe_metrics lists. Valores: PRE_SALE/PRODUCT, AFTER_SALE/ORDER, AFTER_SALE/TICKET, CHAT/PRODUCT, CHAT/ORDER Até 5 itens
metrics	string[]	não	Dictionary metric ids from describe_metrics. Omit for the core set. Até 20 itens
dimensions	string[]	não	Add 'store' for a per-store breakdown. Valores: store Até 1 itens
stores	string[]	não	Opaque store ids from list_stores. Omit for every store. Até 50 itens
limit	integer	não	Padrão: 50 Mínimo: 1 Máximo: 500
cursor	string	não	The meta.next_cursor of a previous call with the same arguments.

list_ad_campaigns

List ad campaigns leitura

List the merchant's Ads campaigns with their budget, strategy, GoBots automation block and a metrics snapshot. Aggregates up to three internal pages per call; when more rows exist the result says so and returns a cursor. Filter by store with ids from list_stores.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
stores	string[]	não	Opaque store ids from list_stores. Até 50 itens
status	string[]	não	Valores: active, paused, ended Até 3 itens
limit	integer	não	Rows per internal page; up to three pages are returned per call. Padrão: 50 Mínimo: 1 Máximo: 500
cursor	string	não	The meta.next_cursor of a previous call with the same arguments.

get_ad_campaign

Get an ad campaign leitura

One campaign in full, including the enriched GoBots automation configuration. Use the campaign id returned by list_ad_campaigns or carried by an opportunity.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
campaign_id	string	sim

get_ads_performance

Get ads performance leitura

Ads performance over a period, as totals and a series by day, week or month: spend, impressions, clicks, ctr, cpc, attributed sales, acos and roas, in each store's currency. Give campaign_id for one campaign; otherwise the answer covers every store of the account, one entry per store plus totals per currency, and store_id narrows it to one store. Accepts a relative period or an explicit start_date and end_date, at most 90 days and no older than 90 days. Days are cut in each store's own time zone; granularity="total" returns the totals alone.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
campaign_id	string	não	One campaign. Omit for the whole account. Not together with store_id.
store_id	string	não	Opaque store id from list_stores, narrowing the account to one store. Not together with campaign_id.
period	string	não	Relative window. Mutually exclusive with start_date/end_date. Defaults to last_30_days when neither is given. Valores: today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, month_to_date, last_month
start_date	string (date)	não	Inclusive ISO 8601 date (YYYY-MM-DD), at most 90 days before today. Give it together with end_date.
end_date	string (date)	não	Inclusive ISO 8601 date (YYYY-MM-DD). Must not be in the future.
timezone	string	não	Omit to use each store's own time zone. When given, it must equal the zone of every store in the answer.
granularity	string	não	Bucket size. 'total' answers the totals and an empty series. Valores: day, week, month, total Padrão: "day"

list_ad_groups

List ad groups leitura

The ad groups of one campaign, each with its status and the marketplace items it advertises. Filter by item_ids to find the group that carries a specific item.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
campaign_id	string	sim
item_ids	string[]	não	Marketplace item ids; keeps only the ad groups that carry one of them. Até 50 itens
limit	integer	não	Padrão: 50 Mínimo: 1 Máximo: 500
cursor	string	não	The meta.next_cursor of a previous call with the same arguments.

list_ad_advertisers

List ad advertiser accounts leitura

The merchant's advertiser accounts on the marketplace. Needed only when a campaign's advertiser has to be named; most workflows never call this.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
limit	integer	não	Padrão: 50 Mínimo: 1 Máximo: 500
cursor	string	não	The meta.next_cursor of a previous call with the same arguments.

list_opportunities

List Ads opportunities leitura

Ads recommendations GoBots generated for this merchant: launch a campaign, optimise it, grow it. Defaults to status="open". detail="concise", the default, keeps only the recommended action line of each description and answers null for its other fields; detail="full" adds the context, diagnosis, reason and expected impact.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
types	string[]	não	Valores: launch_campaign, optimize_campaign, grow_campaign Até 3 itens
status	string[]	não	Defaults to ["open"]. Valores: open, applied, dismissed, manually_applied, expired Até 5 itens
stores	string[]	não	Opaque store ids from list_stores. Até 50 itens
campaign_ids	string[]	não	Até 50 itens
favorite	boolean	não
created_from	string (date)	não	Inclusive ISO 8601 date (YYYY-MM-DD) in 'timezone'.
created_to	string (date)	não	Inclusive ISO 8601 date (YYYY-MM-DD) in 'timezone'. At most 90 days after created_from.
timezone	string	não	IANA time zone of created_from and created_to. Padrão: "UTC"
detail	string	não	concise keeps only the action line of each description and answers null for the rest; full adds context, diagnosis, why and impact. Valores: concise, full Padrão: "concise"
limit	integer	não	Padrão: 50 Mínimo: 1 Máximo: 500
cursor	string	não	The meta.next_cursor of a previous call with the same arguments.

get_opportunity

Get an Ads opportunity leitura

One recommendation in full: the structured GoBots description, the recommended action, and the result if it was already applied.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
opportunity_id	string	sim

update_ad_campaign

Update an ad campaign escrita, pede confirmação

Change a campaign's name, status, daily budget or target ROAS. Status accepts only "active" or "paused"; a campaign that has ended cannot be reactivated. Give at least one field to change. The operator is asked to confirm the exact from -> to change before anything is executed, and the tool will not act without that confirmation. Reuse the same idempotency_key when you retry.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
campaign_id	string	sim
name	string	não
status	string	não	Valores: active, paused
budget_amount	string	não	Positive decimal with at most 2 decimal places, e.g. "180.00". The currency is the campaign's own and cannot be changed.
roas_target	string	não	Decimal between 1.0 and 35.0, e.g. "9.5".
idempotency_key	string	não	A UUID you generate once per intent and reuse on every retry of that same intent.

set_ad_group_status

Set ad group status escrita, pede confirmação

Pause or activate ad groups of one campaign. Target a single group with ad_group_id, or a batch with ad_group_ids or item_ids (at most 50). A batch can only pause; to activate, target one group at a time. The operator is asked to confirm before anything is executed. Reuse the same idempotency_key when you retry.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
campaign_id	string	sim
status	string	sim	Valores: active, paused
ad_group_id	string	não	A single ad group. Use this to activate.
ad_group_ids	string[]	não	A batch. Only status="paused" is accepted with a batch. Até 50 itens
item_ids	string[]	não	A batch selected by marketplace item id. Only status="paused" is accepted with a batch. Até 50 itens
idempotency_key	string	não	A UUID you generate once per intent and reuse on every retry of that same intent.

apply_opportunity

Apply an Ads opportunity escrita, pede confirmação

Execute the change a GoBots recommendation proposes, exactly as proposed. There are no overrides: to set a different value, call update_ad_campaign instead. A recommendation whose action is to remove an ad is applied as a pause of its ad group; nothing is ever deleted. The operator is asked to confirm the proposed change before anything is executed. Applying can be asynchronous on the marketplace; when it is, the result says so and carries an action_id.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
opportunity_id	string	sim
idempotency_key	string	não	A UUID you generate once per intent and reuse on every retry of that same intent.

apply_opportunities

Apply several Ads opportunities escrita, pede confirmação

Execute several GoBots recommendations in one batch, at most 20 per call. Each is applied exactly as proposed. The operator is shown every recommendation in the batch and confirms the whole batch before anything is executed. One recommendation failing does not stop the others; the result lists the outcome per id.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
opportunity_ids	string[]	sim	At most 20 per call. Até 20 itens
idempotency_key	string	não	A UUID you generate once per intent and reuse on every retry of that same intent.

dismiss_opportunity

Dismiss or flag an Ads opportunity escrita

Set a recommendation aside without applying it, mark it as a favourite, hide it, or leave feedback on it. Nothing on the marketplace changes, and the change is recorded at once, without asking the operator. dismiss=true sets the recommendation's status to "dismissed", which is final and cannot be undone. The favorite, hidden and feedback flags work on a recommendation in any status and can be changed again later. Give at least one field to change.

Parâmetro	Tipo	Obrigatório	Descrição
marketplace	string	não	Only meli serves Ads in this version. Valores: meli, amazon, magalu, shopee, viavarejo, b2w, whatsapp, qa, tiktok Padrão: "meli"
opportunity_id	string	sim
dismiss	boolean	não	true sets the recommendation's status to "dismissed", which cannot be undone. false changes nothing.
favorite	boolean	não
hidden	boolean	não
feedback_useful	boolean	não
feedback_comment	string	não
idempotency_key	string	não	A UUID you generate once per intent and reuse on every retry of that same intent.