There are **26 tools**. You will never call one by hand — your assistant picks them for you — so read this the way you would read a menu, not a manual: to know what is possible to ask for.

The useful sections are the last two. **The grain of each tool** explains why some answers come back per day and others per week, and **Six traps** covers the places an assistant can produce a confident wrong number.

[Watch the tool reference walkthrough](https://kb.trackiq.com/kb-assets/kbvideo-mcp-tools-explainer-2bb62174.mp4)

*Prefer to watch? Sixty-seven seconds on how the tools group, and the traps worth knowing.*

![The MCP access screen — one URL, and the tools come with it](/kb-assets/shot-mcp-connect-69e419.png)

## **Start here**

| Tool | What it does |
|---|---|
| `list_marketplaces` | lists your connected marketplaces and whether each is a **Seller**, **Vendor** or **KDP** account |
| `set_context` | records the question being asked, so the call is grouped in your **Call Logs** |

`list_marketplaces` is the first call in almost every conversation, because everything else needs to know which marketplace you mean. It is also why the account type matters: **sellers identify products by SKU, vendors by ASIN**, and the same question takes a different shape on each.

## **Sales, products and stock**

| Tool | Grain | Notes |
|---|---|---|
| `get_account_overview` | per day, **or** one rollup | `sales_trend` for a chart; `advertising_summary` for ACoS, TACoS and ROAS in one row |
| `get_product_performance` | per product, **or** per day | the traffic funnel: sessions → orders → units → revenue |
| `get_product_categories_performance` | per category | how your categories compare |
| `get_inventory_snapshot` | point in time | on hand, inbound, reserved, unfulfillable; **not** a time series |
| `get_bsr` | per product | Best Seller Rank |
| `show_products` | — | renders product cards or a table **with images** |

`show_products` is the only tool that exists purely for presentation, and assistants are told not to call it unless you actually ask to see pictures — so if you want thumbnails, say so.

## **Sponsored Ads**

| Tool | Grain |
|---|---|
| `get_campaigns` | per campaign, or per day |
| `get_campaign_groups` | per campaign group |
| `get_portfolios` | per portfolio |
| `get_ad_groups` | per ad group |
| `get_targets` | per keyword or product target |
| `get_product_ads` | per advertised ASIN |
| `get_search_terms` | per customer search term |

Two behaviours are worth knowing because they change the answer.

**Only enabled entities are counted by default.** Ask “how many campaigns do I have?” and you get the active ones. If you want everything, say *“including paused and archived”*.

**One call covers all three ad types.** `get_campaigns` ranks Sponsored Products, Brands and Display together in a single combined list, tagging each row with its type — so “my top 10 campaigns” genuinely means top 10 across the account, not top 10 of one channel.

## **Amazon DSP**

`get_dsp_performance` is one tool with seven lenses. The metric set is identical each time; only what a row represents changes.

| Lens | One row per |
|---|---|
| `campaign` | DSP campaign |
| `ad_group` | DSP ad group |
| `creative` | creative asset |
| `audience` | target and segment |
| `geography` | country |
| `technology` | device |
| `inventory` | supply source |

DSP uses **ACTIVE / INACTIVE**, not enabled/paused, and defaults to ACTIVE. Every lens reports on a **14-day attribution window** and includes the display-specific columns — detail page views, add-to-cart and new-to-brand purchases. See [**DSP Metrics Explained**](https://kb.trackiq.com/hc/knowledge-base/articles/dsp-metrics-explained).

## **AMC Cloud**

| Tool | Answers |
|---|---|
| `get_amc_ntb_asins` | which products bring in new customers |
| `get_amc_ntb_purchases` | which campaigns bring in new customers |
| `get_amc_time_to_conversion` | how long people take to buy after seeing an ad |
| `get_amc_attribution_paths` | which sequences of ads actually convert |

All four are **monthly**, and each month is a separate cohort of people. They are compared, never added.

## **Search and rank**

| Tool | Grain |
|---|---|
| `get_search_query_performance` | per query, per **week** |
| `get_search_query_cart_analysis` | per query — why it does not convert |
| `get_keyword_rank` | per keyword, per product, per day |

`get_search_query_performance` has a `by_product` switch that changes the question entirely: off, it answers *“how does the market behave on this query?”*; on, it answers *“which of my products owns which search?”*

## **Vendor accounts**

| Tool | Answers |
|---|---|
| `get_vendor_product_sales` | shipped and ordered revenue |
| `get_vendor_inventory_health` | sellable, unsellable, aged inventory |
| `get_vendor_forecasting` | Amazon's demand forecast, with p70 / p80 / p90 bands |

These return nothing on a Seller account, and the sales tools above return nothing on a Vendor account. That is the account type doing its job, not a fault.

![Call Logs records the question and how many tool calls it took](/kb-assets/shot-mcplog2-header-fa1a52.png)

*Call Logs is the quickest way to see which tools an assistant actually reached for — the TOOL CALLS column counts them per question.*

## **The grain of each tool**

This is the single most useful thing to internalise, because it explains almost every “why can it not just tell me X” moment.

| Grain | Which data | Consequence |
|---|---|---|
| **Daily** | sales, ads, rank | daily breakdowns are capped at the **last 30 days** |
| **Weekly** | Search Query Performance | pinned to one week; never blended across weeks |
| **Monthly** | everything AMC | each month is its own cohort |
| **Point in time** | inventory | there is no “stock last Tuesday” |

So *“show me daily spend for the last quarter”* comes back as the last 30 days with a note. That is the cap, not a bug — ask for a total or a weekly roll-up instead.

## **Six traps**

Worth knowing, because a wrong answer here looks entirely plausible.

**Ranks are positions, so lower is better.** “Improve rank” means the number goes down.

**A blank rank is not rank zero.** It means the product was not found within the depth that was checked — different from ranking badly, and very different from zero.

**Combining ad types blends attribution windows.** SP is credited over 7 days, SB and SD over 14. A combined ranking is right for comparing size, wrong for comparing efficiency.

**SQP shares do not add across weeks.** 20% one week and 20% the next is not 40%. See [**SQP Is Weekly**](https://kb.trackiq.com/hc/knowledge-base/articles/sqp-is-weekly-reading-week-cohorts).

**Vendor revenue is the manufacturing view.** Sourcing is a second lens on the same business, never added on top.

**Summed forecast percentiles are a planning heuristic.** A single day's p80 means what it says; ten days of p80 added together does not, because percentiles are not additive. Ask for the mean when you need an exact figure.

## **Not every tool is on every plan**

Some are gated by tier — advertising tools need the Advertising tier or above, and AMC needs a plan that includes AMC. An assistant told a tool is unavailable will say so rather than guess.

See [**MCP Tiers: What Each Plan Unlocks**](https://kb.trackiq.com/hc/knowledge-base/articles/mcp-tiers-what-each-plan-unlocks).

## **Related**

- [**Feed TrackIQ Data into Your Own AI Workflow**](https://kb.trackiq.com/hc/knowledge-base/articles/feed-trackiq-into-your-ai-workflow) — what to actually do with them.
- [**MCP Call Logs: Seeing What Your AI Tools Asked**](https://kb.trackiq.com/hc/knowledge-base/articles/mcp-call-logs) — seeing which tools got used.