Summary
Connects Claude to unsampled, first-party Shopify analytics via 26 read-only tools running on Cloudflare Workers with D1 storage. You get session traces, multi-touch attribution (including Markov models), funnel analysis, revenue leak diagnostics, and UTM tracking that survives Shopify's cross-domain checkout. Useful when GA4 sampling isn't cutting it or you need to debug cart abandonment and attribution in chat instead of exporting CSVs. OAuth 2.1 auth, streamable HTTP transport, works in Claude Desktop and Cursor after you install their Custom Pixel on your store. Tools like pp_diagnose_leaks and pp_acquisition let you ship fixes from the same conversation where you found the problem.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Tools
Public tool metadata for what this MCP can expose to an agent.
27 tools
projects.listList all Clamp projects this credential can access. Returns each project's id, name, and plan ('free', 'pro', or 'growth'). Use this when the user asks "which sites do you see" or when the agent needs a project_id to disambiguate before calling another tool — most other tools...
List all Clamp projects this credential can access. Returns each project's id, name, and plan ('free', 'pro', or 'growth'). Use this when the user asks "which sites do you see" or when the agent needs a project_id to disambiguate before calling another tool — most other tools...
No parameter schema in public metadata yet.
traffic.overviewHigh-level snapshot of website traffic over a period: total pageviews, unique visitors, sessions, bounce rate (%), and average session duration (seconds). Always includes a comparison block with the same metrics for the previous period of equal length plus the absolute and per...12 params
High-level snapshot of website traffic over a period: total pageviews, unique visitors, sessions, bounce rate (%), and average session duration (seconds). Always includes a comparison block with the same metrics for the previous period of equal length plus the absolute and per...
Parameters* required
channelstringTraffic channel. One of: "direct", "organic_search", "organic_social", "paid", "email", "referral".
countrystringISO 3166-1 alpha-2 country code, uppercase (e.g. "US", "GB", "DE", "NL", "JP"). Filter results to visitors from this country.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
referrer_hoststringFilter by referrer hostname (e.g. "news.ycombinator.com", "twitter.com", "github.com"). Use this to see what traffic from a specific source did. Must match the value returned by `traffic.breakdown(...
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_mediumstringFilter by UTM medium (e.g. "cpc", "email", "social"). Case-sensitive.
utm_sourcestringFilter by UTM source (e.g. "google", "twitter", "newsletter"). Case-sensitive, must match the value in the tracking URL.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
events.listGet custom event counts. Without a `name` filter, returns every event name in the period with its total count and unique-visitor count (excludes "pageview" and the SDK-internal "pageview_end"). With a `name` filter, returns the count for that single event, optionally filtered...19 params
Get custom event counts. Without a `name` filter, returns every event name in the period with its total count and unique-visitor count (excludes "pageview" and the SDK-internal "pageview_end"). With a `name` filter, returns the count for that single event, optionally filtered...
Parameters* required
channelstringTraffic channel. One of: "direct", "organic_search", "organic_social", "paid", "email", "referral".
countrystringISO 3166-1 alpha-2 country code, uppercase (e.g. "US", "GB", "DE", "NL", "JP"). Filter results to visitors from this country.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
group_bystringGroup results by this custom property key (e.g. "plan" to see signups broken down by plan). Returns each unique value with its count. Must be used with a name filter.
group_by_typestringType of the group_by property. Defaults to "string". Set to "number"/"boolean" for numeric/boolean properties; results come back stringified ("5", "true") for transport.one of
string · number · booleanlimitnumberMax rows to return (1-50). Defaults to 10.
namestringFilter to a specific event name (e.g. "signup", "checkout_completed", "button_clicked"). Event names are case-sensitive strings set by the developer.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
propertystringA custom property key to filter or group by (e.g. "plan", "source", "button_id"). Property keys are strings, max 128 chars. Only works when a name filter is set.
referrer_hoststringFilter by referrer hostname (e.g. "news.ycombinator.com", "twitter.com", "github.com"). Use this to see what traffic from a specific source did. Must match the value returned by `traffic.breakdown(...
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_mediumstringFilter by UTM medium (e.g. "cpc", "email", "social"). Case-sensitive.
utm_sourcestringFilter by UTM source (e.g. "google", "twitter", "newsletter"). Case-sensitive, must match the value in the tracking URL.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
valuestringFilter to events where the property key equals this value. Must be used together with the "property" parameter. Pass the value as a string regardless of underlying type; combine with "value_type" f...
value_typestringType of the value being filtered. Defaults to "string". Set to "number" or "boolean" when the property is declared as such in event-schema.yaml — otherwise the lookup hits the wrong column and retu...one of
string · number · booleanevents.observed_schemaReturn what's actually firing into ingest as a structured signature, for diffing against the project's authored `event-schema.yaml`. Different shape from the YAML — this is observation, not declaration. Response shape: ``` { period: "30d", events: [ { name: "checkout", count:...3 params
Return what's actually firing into ingest as a structured signature, for diffing against the project's authored `event-schema.yaml`. Different shape from the YAML — this is observation, not declaration. Response shape: ``` { period: "30d", events: [ { name: "checkout", count:...
Parameters* required
include_pageviewsbooleanInclude pageview and pageview_end in the output. Defaults to false.
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
revenue.sumSum revenue from Money-typed event properties. Returns per-currency totals, optionally grouped by a traffic dimension (referrer_host, channel, country, device_type, pathname, utm_source/medium/campaign). Different currencies are never mixed in a single sum — each row is one (g...17 params
Sum revenue from Money-typed event properties. Returns per-currency totals, optionally grouped by a traffic dimension (referrer_host, channel, country, device_type, pathname, utm_source/medium/campaign). Different currencies are never mixed in a single sum — each row is one (g...
Parameters* required
attribution_modelstringAttribution model. "last_touch" (default) groups by the dimensions of the session where revenue fired. "first_touch" joins each revenue event with the visitor's earliest session and groups by that...one of
last_touch · first_touchchannelstringTraffic channel. One of: "direct", "organic_search", "organic_social", "paid", "email", "referral".
countrystringISO 3166-1 alpha-2 country code, uppercase (e.g. "US", "GB", "DE", "NL", "JP"). Filter results to visitors from this country.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
eventstringFilter to a specific event name (e.g. "purchase", "checkout_completed"). Omit to sum Money properties across all events.
group_bystringGroup revenue by a traffic dimension. Returns one row per (dimension, currency) pair. Omit for a single total per currency.one of
referrer_host · channel · country · device_type · pathname · utm_sourcelimitnumberMax rows to return (1-50). Defaults to 10.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
propertystringRestrict the sum to a single Money property key on the event (e.g. "total", "mrr", "ltv"). Omit to sum every Money-typed property on matched events.
referrer_hoststringFilter by referrer hostname (e.g. "news.ycombinator.com", "twitter.com", "github.com"). Use this to see what traffic from a specific source did. Must match the value returned by `traffic.breakdown(...
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_mediumstringFilter by UTM medium (e.g. "cpc", "email", "social"). Case-sensitive.
utm_sourcestringFilter by UTM source (e.g. "google", "twitter", "newsletter"). Case-sensitive, must match the value in the tracking URL.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
users.journeyChronological session history for a single visitor (anonymous_id). Each session collapses to one row showing the start and end timestamps, entry page, channel, referrer host, UTMs, country, device type, pageview count, and the distinct custom event names fired in that session....4 params
Chronological session history for a single visitor (anonymous_id). Each session collapses to one row showing the start and end timestamps, entry page, channel, referrer host, UTMs, country, device type, pageview count, and the distinct custom event names fired in that session....
Parameters* required
anonymous_idstringThe visitor's anonymous_id. From the browser SDK's getAnonymousId() / localStorage clamp_aid; from server-side tracks, whatever you passed as anonymousId.
limitintegerMax sessions to return. Defaults to 50, max 200.
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
errors.listRecent error events with full context. One row per occurrence, returned newest-first. Each row carries the error itself (message, type, stack, fingerprint, handled flag) plus the standard event context (url, browser/OS/device, country, anonymous_id, session_id) — same shape in...10 params
Recent error events with full context. One row per occurrence, returned newest-first. Each row carries the error itself (message, type, stack, fingerprint, handled flag) plus the standard event context (url, browser/OS/device, country, anonymous_id, session_id) — same shape in...
Parameters* required
browserstringFilter by browser name (e.g. "Chrome", "Safari", "Firefox"). Case-sensitive; use the exact value the SDK reports.
countrystringTwo-letter ISO country code (e.g. "US", "DE"). Useful when an error correlates with a CDN edge or a localization issue.
device_typestringFilter by device type. Use this to isolate mobile-only bugs.one of
desktop · mobile · tablet · botfingerprintstringFilter by server-computed fingerprint (16-char hex). Get fingerprints from errors.groups; same fingerprint groups all occurrences of the same bug.
handledstringFilter to handled (manual captureError calls) or unhandled (window.onerror / unhandledrejection auto-capture). Omit to return both.one of
true · falselimitnumberMax rows to return (1-50). Defaults to 10.
messagestringFilter by exact error message (matches the `error.message` property). Use a known message verbatim; substring matching is not supported.
osstringFilter by OS name (e.g. "macOS", "Windows", "iOS", "Android").
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
errors.groupsErrors deduplicated by server-computed fingerprint, with counts and first/last-seen timestamps. The triage view: which bugs are firing most often, affecting the most users, or showing up newly in the period. Each group is one fingerprint (a bug). `count` is total occurrences i...4 params
Errors deduplicated by server-computed fingerprint, with counts and first/last-seen timestamps. The triage view: which bugs are firing most often, affecting the most users, or showing up newly in the period. Each group is one fingerprint (a bug). `count` is total occurrences i...
Parameters* required
limitnumberMax rows to return (1-50). Defaults to 10.
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
sort_bystringOrder groups by total occurrences (default), unique users affected, most recent occurrence, or earliest occurrence. Sort is always descending.one of
count · users_affected · last_seen · first_seenerrors.timelineError count over time, bucketed hourly or daily. Optionally scoped to one fingerprint. Use this to spot regressions ("when did this bug start firing?") or post-deploy spikes ("did the deploy at 14:00 break something?"). Returns a series of { bucket, count } rows. The bucket fi...4 params
Error count over time, bucketed hourly or daily. Optionally scoped to one fingerprint. Use this to spot regressions ("when did this bug start firing?") or post-deploy spikes ("did the deploy at 14:00 break something?"). Returns a series of { bucket, count } rows. The bucket fi...
Parameters* required
fingerprintstringOptional fingerprint (16-char hex from errors.groups) to scope the chart to one bug. Omit for total error rate.
intervalstringBucket size. Defaults to "hour" for periods ≤ 7 days, "day" otherwise.one of
hour · dayperiodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
errors.contextBreadcrumbs leading to one error: the events from the same session, before the error timestamp, in chronological order. The "what was the user doing right before this broke" view that turns a stack trace into a story. Given an anonymous_id and the error's timestamp, finds the...4 params
Breadcrumbs leading to one error: the events from the same session, before the error timestamp, in chronological order. The "what was the user doing right before this broke" view that turns a stack trace into a story. Given an anonymous_id and the error's timestamp, finds the...
Parameters* required
anonymous_idstringThe visitor whose session leading up to the error you want to inspect. Pull this from an errors.list row.
before_timestampstringISO 8601 timestamp of the error itself. Returns events strictly earlier than this from the same session.
limitintegerMax events to return. Defaults to 20, max 100. Increase only if a longer breadcrumb is needed; agents typically read the most recent ones first.
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
traffic.timeseriesEvent counts over time as date buckets. Returns [{ date, count }] sorted ascending. Granularity is automatic based on period length (hourly for ≤2 days, daily for ≤90 days, weekly for ≤365 days, monthly beyond) and can be overridden via `granularity`. Filterable to a specific...16 params
Event counts over time as date buckets. Returns [{ date, count }] sorted ascending. Granularity is automatic based on period length (hourly for ≤2 days, daily for ≤90 days, weekly for ≤365 days, monthly beyond) and can be overridden via `granularity`. Filterable to a specific...
Parameters* required
channelstringTraffic channel. One of: "direct", "organic_search", "organic_social", "paid", "email", "referral".
countrystringISO 3166-1 alpha-2 country code, uppercase (e.g. "US", "GB", "DE", "NL", "JP"). Filter results to visitors from this country.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
eventstringEvent name to chart. Defaults to "pageview". Use any custom event name to see its trend over time.
granularitystringOverride the automatic granularity. "hour" for hourly buckets, "day" for daily, "week" for weekly, "month" for monthly. If omitted, chosen automatically based on the period length.one of
hour · day · week · monthpathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
propertystringFilter by this custom property key (used with value).
referrer_hoststringFilter by referrer hostname (e.g. "news.ycombinator.com", "twitter.com", "github.com"). Use this to see what traffic from a specific source did. Must match the value returned by `traffic.breakdown(...
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_mediumstringFilter by UTM medium (e.g. "cpc", "email", "social"). Case-sensitive.
utm_sourcestringFilter by UTM source (e.g. "google", "twitter", "newsletter"). Case-sensitive, must match the value in the tracking URL.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
valuestringFilter to events where the property key equals this value.
funnels.createCreate and immediately evaluate a conversion funnel. A funnel measures how many unique visitors complete an ordered sequence of steps. Returns step-by-step counts, per-step conversion rates (vs the previous step), and overall conversion (last step / first step). The funnel is...3 params
Create and immediately evaluate a conversion funnel. A funnel measures how many unique visitors complete an ordered sequence of steps. Returns step-by-step counts, per-step conversion rates (vs the previous step), and overall conversion (last step / first step). The funnel is...
Parameters* required
namestringA descriptive name for this funnel (e.g. "pricing-to-signup", "onboarding-flow"). Used to retrieve it later. Max 200 chars.
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
stepsarrayOrdered array of 2-10 funnel steps. Each step: a custom event name ("signup"), a pathname-scoped pageview ("pageview:/pricing"), or either form with property predicates appended in brackets ("cta_c...
funnels.listRetrieve and re-evaluate a previously created funnel against current data for the specified period. Without a `name`, lists all funnels saved for the project. With a `name`, returns the same step-by-step counts and conversion rates as funnels.create, recomputed for the request...13 params
Retrieve and re-evaluate a previously created funnel against current data for the specified period. Without a `name`, lists all funnels saved for the project. With a `name`, returns the same step-by-step counts and conversion rates as funnels.create, recomputed for the request...
Parameters* required
channelstringTraffic channel. One of: "direct", "organic_search", "organic_social", "paid", "email", "referral".
countrystringISO 3166-1 alpha-2 country code, uppercase (e.g. "US", "GB", "DE", "NL", "JP"). Filter results to visitors from this country.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
namestringThe funnel name to retrieve. Omit to list all funnels for the project.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
referrer_hoststringFilter by referrer hostname (e.g. "news.ycombinator.com", "twitter.com", "github.com"). Use this to see what traffic from a specific source did. Must match the value returned by `traffic.breakdown(...
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_mediumstringFilter by UTM medium (e.g. "cpc", "email", "social"). Case-sensitive.
utm_sourcestringFilter by UTM source (e.g. "google", "twitter", "newsletter"). Case-sensitive, must match the value in the tracking URL.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
cohorts.createCreate and persist a named cohort — a group of visitors defined by an event in a period, optionally narrowed by a property filter. The cohort is stored by name; subsequent retention/compare queries reference it without re-specifying the definition. Membership is recomputed at...3 params
Create and persist a named cohort — a group of visitors defined by an event in a period, optionally narrowed by a property filter. The cohort is stored by name; subsequent retention/compare queries reference it without re-specifying the definition. Membership is recomputed at...
Parameters* required
definitionobjectEvent-based cohort definition.
namestringCohort name. Lowercase alphanumeric, hyphens, underscores. Used as the handle for retention / compare / delete.
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
cohorts.listList saved cohorts for the project. With `name`, returns one cohort with its current size; without, returns every cohort with their definitions. Use to discover cohort handles before calling retention or compare. Examples: - "what cohorts do I have" → no params - "show me the...2 params
List saved cohorts for the project. With `name`, returns one cohort with its current size; without, returns every cohort with their definitions. Use to discover cohort handles before calling retention or compare. Examples: - "what cohorts do I have" → no params - "show me the...
Parameters* required
namestringCohort name to fetch one. Omit to list all.
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
cohorts.retentionCompute the retention curve for a saved cohort. For each requested window (e.g. day 1, 7, 14, 30 after the cohort's anchor event), returns how many cohort members fired any non-pageview-end event in that day's window, and the rate vs the cohort size. Use this to answer "did th...3 params
Compute the retention curve for a saved cohort. For each requested window (e.g. day 1, 7, 14, 30 after the cohort's anchor event), returns how many cohort members fired any non-pageview-end event in that day's window, and the rate vs the cohort size. Use this to answer "did th...
Parameters* required
namestringCohort name to query.
periodsstringComma-separated retention windows. Each is `<n>d` or `<n>w` (e.g. "1d,7d,14d,30d" or "1w,2w,4w,8w"). Defaults to "1d,7d,14d,30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
cohorts.compareCompare two saved cohorts side-by-side on retention. Returns each cohort's size and retention curve over the same period set, so you can read "did this week's signups retain better than last week's?" or "is this experiment cohort behaving differently than control?" without com...4 params
Compare two saved cohorts side-by-side on retention. Returns each cohort's size and retention curve over the same period set, so you can read "did this week's signups retain better than last week's?" or "is this experiment cohort behaving differently than control?" without com...
Parameters* required
astringName of the first cohort.
bstringName of the second cohort.
periodsstringComma-separated retention windows, same format as cohorts.retention.
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
cohorts.deleteDelete a saved cohort by name. Irreversible — the agent should confirm intent with the user before calling this. The underlying event data isn't touched; only the cohort definition row is removed. Examples: - "delete the test cohort" → name="test_cohort" Limitations: irreversi...2 params
Delete a saved cohort by name. Irreversible — the agent should confirm intent with the user before calling this. The underlying event data isn't touched; only the cohort definition row is removed. Examples: - "delete the test cohort" → name="test_cohort" Limitations: irreversi...
Parameters* required
namestringCohort name to delete.
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
alerts.createCreate a metric alert that fires when a condition crosses its threshold. The alert monitors one metric (pageviews, visitors, sessions, bounce_rate, or avg_duration) over a rolling period and is re-evaluated every time an MCP session connects — alerts surface in-thread when the...6 params
Create a metric alert that fires when a condition crosses its threshold. The alert monitors one metric (pageviews, visitors, sessions, bounce_rate, or avg_duration) over a rolling period and is re-evaluated every time an MCP session connects — alerts surface in-thread when the...
Parameters* required
conditionstringAlert condition. "above" = metric exceeds threshold, "below" = metric falls below threshold, "drops_by" = metric drops by threshold % compared to previous period, "increases_by" = metric increases...one of
above · below · drops_by · increases_bymetricstringThe metric to monitor. "pageviews" = total page views, "visitors" = unique visitors, "sessions" = total sessions, "bounce_rate" = % of single-page sessions (0-100), "avg_duration" = average session...one of
pageviews · visitors · sessions · bounce_rate · avg_durationpathnamestringScope the alert to a specific page path (e.g. "/pricing"). Omit to monitor all pages.
periodstringEvaluation window. Use "7d", "30d", etc. Defaults to "7d". Compared against the previous period of the same length.
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
thresholdnumberThreshold value. For "above"/"below": the absolute metric value (e.g. 1000 pageviews). For "drops_by"/"increases_by": the percentage change (e.g. 50 means 50% drop/increase).
alerts.listList all alerts configured for a project. Returns each alert's id (UUID), metric, condition, threshold, period, optional pathname scope, and created_at timestamp. Use before alerts.delete to find the id you want to remove, or to show the user every monitor currently active. Re...1 params
List all alerts configured for a project. Returns each alert's id (UUID), metric, condition, threshold, period, optional pathname scope, and created_at timestamp. Use before alerts.delete to find the id you want to remove, or to show the user every monitor currently active. Re...
Parameters* required
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
alerts.deleteDelete an alert by its id. Find the id by calling alerts.list first. The deletion is irreversible — there is no soft-delete or undo, and the agent should confirm intent with the user before calling this on a non-trivial alert. Returns 404 if no alert with that id exists for th...2 params
Delete an alert by its id. Find the id by calling alerts.list first. The deletion is irreversible — there is no soft-delete or undo, and the agent should confirm intent with the user before calling this on a non-trivial alert. Returns 404 if no alert with that id exists for th...
Parameters* required
alert_idstringThe alert id (UUID) to delete. Get this from alerts.list.
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
traffic.breakdownAggregate visitors and pageviews grouped by a single dimension. The `dimension` parameter chooses what to group by — page paths, traffic sources, geography, devices, or marketing attribution. Results are sorted by visitors descending and capped by `limit` (default 10, max 50)....14 params
Aggregate visitors and pageviews grouped by a single dimension. The `dimension` parameter chooses what to group by — page paths, traffic sources, geography, devices, or marketing attribution. Results are sorted by visitors descending and capped by `limit` (default 10, max 50)....
Parameters* required
channelstringTraffic channel. One of: "direct", "organic_search", "organic_social", "paid", "email", "referral".
countrystringISO 3166-1 alpha-2 country code, uppercase (e.g. "US", "GB", "DE", "NL", "JP"). Filter results to visitors from this country.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
dimensionstringWhat to group by. Page paths: "pathname", "entry_page", "exit_page". Traffic sources: "referrer_host" (returns channel too), "channel", "utm_source", "utm_medium", "utm_campaign", "utm_content", "u...one of
pathname · entry_page · exit_page · referrer_host · channel · countrylimitnumberMax rows to return (1-50). Defaults to 10.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
referrer_hoststringFilter by referrer hostname (e.g. "news.ycombinator.com", "twitter.com", "github.com"). Use this to see what traffic from a specific source did. Must match the value returned by `traffic.breakdown(...
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_mediumstringFilter by UTM medium (e.g. "cpc", "email", "social"). Case-sensitive.
utm_sourcestringFilter by UTM source (e.g. "google", "twitter", "newsletter"). Case-sensitive, must match the value in the tracking URL.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
traffic.compareCompare one metric across two arbitrary periods side-by-side. Returns both period values plus absolute delta and percentage delta. Periods do not need to be the same length — the percentage delta normalizes by ratio so longer/shorter comparisons remain meaningful. Use when the...14 params
Compare one metric across two arbitrary periods side-by-side. Returns both period values plus absolute delta and percentage delta. Periods do not need to be the same length — the percentage delta normalizes by ratio so longer/shorter comparisons remain meaningful. Use when the...
Parameters* required
astringFirst period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range "YYYY-MM-DD:YYYY-MM-DD".
bstringSecond period. Same format as `a`.
channelstringTraffic channel. One of: "direct", "organic_search", "organic_social", "paid", "email", "referral".
countrystringISO 3166-1 alpha-2 country code, uppercase (e.g. "US", "GB", "DE", "NL", "JP"). Filter results to visitors from this country.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
metricstringThe metric to compare.one of
pageviews · visitors · sessions · bounce_rate · avg_durationpathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
referrer_hoststringFilter by referrer hostname (e.g. "news.ycombinator.com", "twitter.com", "github.com"). Use this to see what traffic from a specific source did. Must match the value returned by `traffic.breakdown(...
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_mediumstringFilter by UTM medium (e.g. "cpc", "email", "social"). Case-sensitive.
utm_sourcestringFilter by UTM source (e.g. "google", "twitter", "newsletter"). Case-sensitive, must match the value in the tracking URL.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
sessions.pathsAggregate (entry_page → exit_page) session pairs. Returns the top pairs with how many sessions followed each path, average pages per session, average duration in seconds, and a bounce flag. Use to answer "what do visitors do after landing on /pricing", "where do sessions end",...14 params
Aggregate (entry_page → exit_page) session pairs. Returns the top pairs with how many sessions followed each path, average pages per session, average duration in seconds, and a bounce flag. Use to answer "what do visitors do after landing on /pricing", "where do sessions end",...
Parameters* required
channelstringTraffic channel. One of: "direct", "organic_search", "organic_social", "paid", "email", "referral".
countrystringISO 3166-1 alpha-2 country code, uppercase (e.g. "US", "GB", "DE", "NL", "JP"). Filter results to visitors from this country.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
limitnumberMax rows to return (1-50). Defaults to 10.
min_pagesintegerMinimum pageviews in a session to include it. Defaults to 1 (include bounces). Set to 2 to exclude single-page sessions.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
referrer_hoststringFilter by referrer hostname (e.g. "news.ycombinator.com", "twitter.com", "github.com"). Use this to see what traffic from a specific source did. Must match the value returned by `traffic.breakdown(...
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_mediumstringFilter by UTM medium (e.g. "cpc", "email", "social"). Case-sensitive.
utm_sourcestringFilter by UTM source (e.g. "google", "twitter", "newsletter"). Case-sensitive, must match the value in the tracking URL.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
pages.engagementPer-page metrics with a selectable detail level. The `view` parameter chooses what comes back: - view="summary" (default): pathname, pageviews, visitors. Cheap; use as the standard "top pages" call. - view="engagement": adds avg_engagement_seconds (active tab time from the SDK...14 params
Per-page metrics with a selectable detail level. The `view` parameter chooses what comes back: - view="summary" (default): pathname, pageviews, visitors. Cheap; use as the standard "top pages" call. - view="engagement": adds avg_engagement_seconds (active tab time from the SDK...
Parameters* required
channelstringTraffic channel. One of: "direct", "organic_search", "organic_social", "paid", "email", "referral".
countrystringISO 3166-1 alpha-2 country code, uppercase (e.g. "US", "GB", "DE", "NL", "JP"). Filter results to visitors from this country.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
limitnumberMax rows to return (1-50). Defaults to 10.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
periodstringTime period. Use "today", "yesterday", "7d", "30d", "90d", or a custom range as "YYYY-MM-DD:YYYY-MM-DD" (e.g. "2026-01-01:2026-03-31"). Defaults to "30d".
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
referrer_hoststringFilter by referrer hostname (e.g. "news.ycombinator.com", "twitter.com", "github.com"). Use this to see what traffic from a specific source did. Must match the value returned by `traffic.breakdown(...
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_mediumstringFilter by UTM medium (e.g. "cpc", "email", "social"). Case-sensitive.
utm_sourcestringFilter by UTM source (e.g. "google", "twitter", "newsletter"). Case-sensitive, must match the value in the tracking URL.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
viewstringDetail level. "summary" (default) returns pathname/pageviews/visitors only. "engagement" adds avg_engagement_seconds and bounce_rate. "sections" returns per-section view counts for the pathname (re...one of
summary · engagement · sectionstraffic.liveSee who is on the site in the last N minutes. Returns the active visitor count plus top pages, top referrers, and top countries within that window. Defaults to 5 minutes; max 60. Use during incidents ("is anyone hitting the broken page right now"), launches ("is the new post g...2 params
See who is on the site in the last N minutes. Returns the active visitor count plus top pages, top referrers, and top countries within that window. Defaults to 5 minutes; max 60. Use during incidents ("is anyone hitting the broken page right now"), launches ("is the new post g...
Parameters* required
project_idstringTarget project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projec...
window_minutesintegerLookback window in minutes. Defaults to 5, max 60.
docs.searchKeyword-search the Clamp documentation index for setup, SDK, MCP, concepts, and skills pages. Returns ranked entries with url, title, and a short description. Each match scores higher when query terms appear in the title than the description; results are capped by `limit` (def...2 params
Keyword-search the Clamp documentation index for setup, SDK, MCP, concepts, and skills pages. Returns ranked entries with url, title, and a short description. Each match scores higher when query terms appear in the title than the description; results are capped by `limit` (def...
Parameters* required
limitintegerMax results. Defaults to 5.
querystringSearch query.
Profitpather — MCP server
Profitpather is a first-party, unsampled analytics layer for Shopify stores. This is its public Model Context Protocol server — 26 tools that give AI agents live, raw, every-event access to merchant traffic, attribution, funnels, and revenue-leak diagnostics.
- Registry name:
com.profitpather/analytics(DNS-verified viaprofitpather.com) - Endpoint:
https://profitpather.com/mcp - Transport: Streamable HTTP (protocol versions
2025-11-25·2025-06-18·2025-03-26·2024-11-05) - Auth: OAuth 2.1 with Dynamic Client Registration (RFC 7591)
- Docs (LLM-ready): profitpather.com/llms-full.txt
- Server card: profitpather.com/.well-known/mcp/server-card.json
Why Profitpather
| Alternative | Limitation Profitpather solves |
|---|---|
| GA4 / Shopify Reports | Aggressively sampled, third-party-cookie dependent, drops UTMs across the Shopify cross-domain checkout — designed to feed Google Ads, not to answer "where did this cart actually start?" |
| Meta / TikTok / Google Ads dashboards | Self-reported clicks, regularly over-attribute, can't see on-domain behaviour |
| Triple Whale / Northbeam / Polar ($150–$1,500/mo) | Closed paid suites, not Claude-native, not MCP-accessible |
| Heap / Mixpanel / Amplitude | Generic product analytics — don't understand Shopify cart-goal logic, pre-cart paths, checkout linkage, store-domain attribution |
Profitpather is unsampled, first-party, Shopify-native, and agent-native by design — analyse in chat, ship fixes from chat.
Tools (26)
Headline tools (the ones agents reach for first):
| Tool | Purpose |
|---|---|
pp_list_domains | List every Shopify domain this account can query. Call first. |
pp_brief | One-call first look — overview + acquisition + device + pixel-status in parallel, with a pre-formatted markdown presentation. |
pp_diagnose_leaks | Revenue-leak finder. Aggregates 8 analyses into a prioritised recommendations[] array. |
pp_overview | Top-level KPIs for one window: sessions, cart rate, checkout rate, top sources, top landing pages. |
pp_acquisition | Full attribution matrix — every (source, medium, campaign, utm, click-id) combo with revenue, AOV, conversion rates. |
pp_conversion | Funnel + pre-cart paths + checkout economics broken down by stage. |
pp_path_analysis | Page-to-page flows with cart-rate weighting; finds dead-end transitions. |
pp_markov | Markov-chain attribution model across multi-touch journeys. |
pp_in_app_browser_loss | Revenue at risk from in-app browsers (Instagram, TikTok, Facebook). |
pp_session_trace | Full per-session event timeline for a single visitor. |
pp_pixel_status | Pixel health & coverage check. |
pp_compare_periods | Period-over-period comparison with statistical significance. |
pp_ai_insights | LLM-summarised insights pre-computed nightly. |
pp_signals | All measured behavioural signals on a domain. |
Plus 12 more covering device splits, page-lift attribution, product analytics, search, timeseries, real-time today-view, change log, admin status, etc.
Full per-tool schemas at: profitpather.com/.well-known/agent-skills/index.json
Install
Claude Desktop / Claude Code / Cursor
{
"mcpServers": {
"profitpather": {
"url": "https://profitpather.com/mcp"
}
}
}
Restart the client. On first tool call, you'll be redirected through OAuth 2.1 to authorise the connection. Sign in with your Profitpather account, approve, and the client stores the token automatically.
ChatGPT / Claude.ai Custom Connectors
Settings → Connectors → Add custom connector → paste https://profitpather.com/mcp → approve OAuth.
No Profitpather account yet?
Sign up at profitpather.com, install the single Shopify Custom Pixel on your store, and Profitpather starts collecting events immediately. The MCP becomes useful within minutes of the pixel firing.
Architecture
Profitpather runs entirely on Cloudflare Workers with D1 (SQLite at the edge) for per-merchant event storage. The MCP endpoint at /mcp is the same Worker that serves the dashboard at profitpather.com/dashboard — analytics queries hit D1 directly with no intermediate cache or sampling.
Shopify Custom Pixel (storefront)
│
▼
Cloudflare Worker ───────► D1 (per-merchant event store)
│ ▲
▼ │
/mcp (MCP server) ─── reads ──────┘
│
▼
AI agent (Claude / ChatGPT / Cursor / your app)
All 26 MCP tools are read-only against the merchant's own data — no cross-tenant access, no third-party data sharing.
Discovery endpoints
Profitpather publishes the full agentic-discovery surface:
| Path | What it returns |
|---|---|
/.well-known/mcp/server-card.json | MCP server card v1 (SEP-1649) |
/.well-known/oauth-protected-resource | OAuth 2.1 discovery (RFC 9728) |
/.well-known/api-catalog | RFC 9727 API catalogue |
/.well-known/agent-skills/index.json | Per-tool agent skills with SHA-256 digests (Cloudflare RFC v0.2.0) |
/llms-full.txt | Full Markdown documentation for LLM ingestion |
/llms.txt | LLM index |
License
MIT — see LICENSE.
Built by Boolsai · Contact: founder@boolsai.ai
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Registryactive
TransportHTTP
UpdatedMay 19, 2026
