Documentation

Tool reference

Click Context exposes 37 tools over MCP. You do not call them by hand — you ask a question, and your assistant picks. This page exists so you can check what it picked, learn what a number means, and steer the assistant when it reaches for the wrong one.

You are not the caller

Tool names are useful in a prompt as a hint — “use get_funnel_analysis segmented by device” — but you never need them. Plain questions work. See Getting good answers for how the server steers your assistant on its own.

Shared parameters

These repeat across most tools, so they are documented once here. Each tool page lists only the parameters unique to it, plus a line saying which of these sets it accepts.

Identity

merchantId
stringdefault: your authenticated store
Which store to query. Resolved from your connection, so you never pass it. Present only for support staff working across stores.

Date window

Omit both and you get the last 30 days from the server clock. Every date-scoped response echoes a _meta.dataCoverage block with the range that actually holds data — read it before concluding that an empty result means broken tracking. See Data freshness.

dateFrom
stringdefault: 30 days ago
Start of the window, YYYY-MM-DD. Inclusive.
dateTo
stringdefault: today
End of the window, YYYY-MM-DD. Inclusive.

Session filters

Available on the tools that read session-level data. Combine them freely: device: "mobile" plus utmSource: "google" is one audience.

device
enum
Keep only sessions on this device class.
mobiletabletdesktop
visitorType
enum
Keep only first-time or only returning visitors.
newreturning
utmSource
string
Keep only sessions from this UTM source, for example google.
utmMedium
string
Keep only sessions from this UTM medium, for example cpc.
utmCampaign
string
Keep only sessions from this UTM campaign name.
theme
string
Keep only sessions that rendered this Shopify theme id (bare numeric id). Use it to isolate one arm of a theme A/B test. Sessions recorded before 7 August 2026 carry no theme id and drop out.

All tools

Grouped by the job they do. Within a group, the tools are ordered by how often they earn their place in an investigation.

Start here

Three tools that tell you where to look. Run one of these before anything else.

Funnel and conversion

Where visitors drop out, which segments are broken, and what the drop costs.

Page and element diagnostics

What is wrong with a specific page — clicks, structure, speed, errors, forms.

get_top_issues

The store's worst pages by rage-click rate, dead-click rate, bounce rate or scroll depth, each labelled with the issue type.

get_element_click_analysis

Click statistics per HTML element (CSS selector) — total, rage and dead clicks — optionally aggregated across every page of a template.

get_page_dom_snapshot

The real rendered DOM of pages visitors actually loaded, pruned to structural elements with classes, IDs, text and nesting.

get_click_heatmap

A 10-by-10 grid of a page showing which zones receive clicks, with rage and dead breakdowns per zone, plus an ASCII rendering.

get_click_analysis

Click totals for one page — normal, rage and dead — with the rates and DTC benchmarks attached.

get_page_vitals

Core Web Vitals per page — LCP, INP, CLS and TTFB at p75 — graded against Google's official good, needs-improvement and poor bands.

get_page_performance

Per-page engagement — views, unique visitors, average duration, scroll depth, bounce rate, rage and dead-click rates, plus p75 LCP.

get_form_analytics

Completion rate per form and — the key signal — which field visitors were on when they abandoned.

get_hover_analysis

Hover-dwell statistics per element, including the elements visitors stared at but never clicked.

get_section_visibility

Which page sections visitors actually saw, how much of each was visible, and for how long.

get_js_errors

JavaScript exceptions on the storefront — message, affected pages, frequency, and first and last seen.

get_page_templates

The Shopify theme's templates — which sections appear on each page type, in what order, with their settings.

Products and discovery

Catalogue state, per-product behaviour, and what visitors search for.

Individual sessions

Raw journeys and AI-written narratives of what one visitor did.

Measuring a change

Did the fix work? Compare the windows either side of a deploy.

Custom events

Track something the standard schema does not cover — discover it, test it, ship it.