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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
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".
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.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
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 `projects.list` to discover available project IDs.
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.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
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(dimension="referrer_host")` exactly (lowercase, no protocol or path).
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
namestringFilter to a specific event name (e.g. "signup", "checkout_completed", "button_clicked"). Event names are case-sensitive strings set by the developer.
limitnumberMax rows to return (1-50). Defaults to 10.
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" for numbers/booleans.
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".
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.
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.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
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.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
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 `projects.list` to discover available project IDs.
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.
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 returns no matches.one of
string · number · booleandevice_typestringDevice category. One of: "desktop", "mobile", "tablet".
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
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 · booleanreferrer_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(dimension="referrer_host")` exactly (lowercase, no protocol or path).
events.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
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 `projects.list` to discover available project IDs.
include_pageviewsbooleanInclude pageview and pageview_end in the output. Defaults to false.
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
eventstringFilter to a specific event name (e.g. "purchase", "checkout_completed"). Omit to sum Money properties across all events.
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".
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.
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_sourcepathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
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.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
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 `projects.list` to discover available project IDs.
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.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
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(dimension="referrer_host")` exactly (lowercase, no protocol or path).
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 session's acquisition dim. First-touch only supports group_by in acquisition dimensions (channel, referrer_host, utm_*).one of
last_touch · first_touchusers.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
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 `projects.list` to discover available project IDs.
anonymous_idstringThe visitor's anonymous_id. From the browser SDK's getAnonymousId() / localStorage clamp_aid; from server-side tracks, whatever you passed as anonymousId.
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
osstringFilter by OS name (e.g. "macOS", "Windows", "iOS", "Android").
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".
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.
handledstringFilter to handled (manual captureError calls) or unhandled (window.onerror / unhandledrejection auto-capture). Omit to return both.one of
true · falsemessagestringFilter by exact error message (matches the `error.message` property). Use a known message verbatim; substring matching is not supported.
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 `projects.list` to discover available project IDs.
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.
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".
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_seenproject_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 `projects.list` to discover available project IDs.
errors.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
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".
intervalstringBucket size. Defaults to "hour" for periods ≤ 7 days, "day" otherwise.one of
hour · dayproject_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 `projects.list` to discover available project IDs.
fingerprintstringOptional fingerprint (16-char hex from errors.groups) to scope the chart to one bug. Omit for total error rate.
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
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 `projects.list` to discover available project IDs.
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.
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
eventstringEvent name to chart. Defaults to "pageview". Use any custom event name to see its trend over time.
valuestringFilter to events where the property key equals this value.
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".
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.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
propertystringFilter by this custom property key (used with value).
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
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 `projects.list` to discover available project IDs.
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.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
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 · monthutm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
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(dimension="referrer_host")` exactly (lowercase, no protocol or path).
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.
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_click[location=hero_primary]", "pageview:/pricing[utm_source=google]"). Stack predicates to AND them: "cta_click[location=hero_primary][plan=pro]". Predicates default to string matching; append ":n" for number ("checkout[items:n=3]"), ":b" for boolean ("purchase[refunded:b=false]"), or ":s" to force string when the value looks numeric ("plan:s=5").
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 `projects.list` to discover available project IDs.
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
namestringThe funnel name to retrieve. Omit to list all funnels for the project.
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".
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.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
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 `projects.list` to discover available project IDs.
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.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
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(dimension="referrer_host")` exactly (lowercase, no protocol or path).
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
namestringCohort name. Lowercase alphanumeric, hyphens, underscores. Used as the handle for retention / compare / delete.
definitionobjectEvent-based cohort definition.
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 `projects.list` to discover available project IDs.
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 `projects.list` to discover available project IDs.
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 `projects.list` to discover available project IDs.
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 `projects.list` to discover available project IDs.
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 `projects.list` to discover available project IDs.
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
metricstringThe 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 length in seconds.one of
pageviews · visitors · sessions · bounce_rate · avg_durationperiodstringEvaluation window. Use "7d", "30d", etc. Defaults to "7d". Compared against the previous period of the same length.
pathnamestringScope the alert to a specific page path (e.g. "/pricing"). Omit to monitor all pages.
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 by threshold % compared to previous period.one of
above · below · drops_by · increases_bythresholdnumberThreshold 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).
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 `projects.list` to discover available project IDs.
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 `projects.list` to discover available project IDs.
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 `projects.list` to discover available project IDs.
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
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".
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.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
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", "utm_term". Geography: "country", "region", "city" (returns country too). Devices: "device_type", "browser", "browser_version", "os", "os_version".one of
pathname · entry_page · exit_page · referrer_host · channel · countryproject_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 `projects.list` to discover available project IDs.
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.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
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(dimension="referrer_host")` exactly (lowercase, no protocol or path).
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`.
metricstringThe metric to compare.one of
pageviews · visitors · sessions · bounce_rate · avg_durationchannelstringTraffic 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.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
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 `projects.list` to discover available project IDs.
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.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
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(dimension="referrer_host")` exactly (lowercase, no protocol or path).
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
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".
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.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
min_pagesintegerMinimum pageviews in a session to include it. Defaults to 1 (include bounces). Set to 2 to exclude single-page sessions.
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 `projects.list` to discover available project IDs.
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.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
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(dimension="referrer_host")` exactly (lowercase, no protocol or path).
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
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 (requires pathname).one of
summary · engagement · sectionslimitnumberMax 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".
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.
pathnamestringFilter to a specific page path (e.g. "/pricing", "/blog/my-post"). Must start with /.
utm_termstringFilter by UTM term (e.g. "running+shoes"). Case-sensitive.
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 `projects.list` to discover available project IDs.
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.
device_typestringDevice category. One of: "desktop", "mobile", "tablet".
utm_contentstringFilter by UTM content (e.g. "hero-cta", "sidebar-banner"). Case-sensitive.
utm_campaignstringFilter by UTM campaign name (e.g. "spring-launch", "product-hunt"). Case-sensitive.
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(dimension="referrer_host")` exactly (lowercase, no protocol or path).
traffic.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 `projects.list` to discover available project IDs.
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
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Registryactive
TransportHTTP
UpdatedMay 19, 2026
