{
  "markdown": "# Profitpather — MCP server\n\n[![MCP](https://img.shields.io/badge/MCP-streamable--http-blue)](https://modelcontextprotocol.io)\n[![OAuth 2.1](https://img.shields.io/badge/auth-OAuth%202.1-green)](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-v2-1)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n**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.\n\n- **Registry name:** [`com.profitpather/analytics`](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.profitpather) (DNS-verified via `profitpather.com`)\n- **Endpoint:** `https://profitpather.com/mcp`\n- **Transport:** Streamable HTTP (protocol versions `2025-11-25` · `2025-06-18` · `2025-03-26` · `2024-11-05`)\n- **Auth:** OAuth 2.1 with Dynamic Client Registration (RFC 7591)\n- **Docs (LLM-ready):** [profitpather.com/llms-full.txt](https://profitpather.com/llms-full.txt)\n- **Server card:** [profitpather.com/.well-known/mcp/server-card.json](https://profitpather.com/.well-known/mcp/server-card.json)\n\n---\n\n## Why Profitpather\n\n| Alternative | Limitation Profitpather solves |\n|---|---|\n| 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?\" |\n| Meta / TikTok / Google Ads dashboards | Self-reported clicks, regularly over-attribute, can't see on-domain behaviour |\n| Triple Whale / Northbeam / Polar ($150–$1,500/mo) | Closed paid suites, not Claude-native, not MCP-accessible |\n| Heap / Mixpanel / Amplitude | Generic product analytics — don't understand Shopify cart-goal logic, pre-cart paths, checkout linkage, store-domain attribution |\n\nProfitpather is **unsampled**, **first-party**, **Shopify-native**, and **agent-native by design** — analyse in chat, ship fixes from chat.\n\n---\n\n## Tools (26)\n\nHeadline tools (the ones agents reach for first):\n\n| Tool | Purpose |\n|---|---|\n| `pp_list_domains` | List every Shopify domain this account can query. Call first. |\n| `pp_brief` | One-call first look — overview + acquisition + device + pixel-status in parallel, with a pre-formatted markdown presentation. |\n| `pp_diagnose_leaks` | Revenue-leak finder. Aggregates 8 analyses into a prioritised `recommendations[]` array. |\n| `pp_overview` | Top-level KPIs for one window: sessions, cart rate, checkout rate, top sources, top landing pages. |\n| `pp_acquisition` | Full attribution matrix — every (source, medium, campaign, utm, click-id) combo with revenue, AOV, conversion rates. |\n| `pp_conversion` | Funnel + pre-cart paths + checkout economics broken down by stage. |\n| `pp_path_analysis` | Page-to-page flows with cart-rate weighting; finds dead-end transitions. |\n| `pp_markov` | Markov-chain attribution model across multi-touch journeys. |\n| `pp_in_app_browser_loss` | Revenue at risk from in-app browsers (Instagram, TikTok, Facebook). |\n| `pp_session_trace` | Full per-session event timeline for a single visitor. |\n| `pp_pixel_status` | Pixel health & coverage check. |\n| `pp_compare_periods` | Period-over-period comparison with statistical significance. |\n| `pp_ai_insights` | LLM-summarised insights pre-computed nightly. |\n| `pp_signals` | All measured behavioural signals on a domain. |\n\nPlus 12 more covering device splits, page-lift attribution, product analytics, search, timeseries, real-time today-view, change log, admin status, etc.\n\nFull per-tool schemas at: [profitpather.com/.well-known/agent-skills/index.json](https://profitpather.com/.well-known/agent-skills/index.json)\n\n---\n\n## Install\n\n### Claude Desktop / Claude Code / Cursor\n\n```json\n{\n  \"mcpServers\": {\n    \"profitpather\": {\n      \"url\": \"https://profitpather.com/mcp\"\n    }\n  }\n}\n```\n\nRestart 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.\n\n### ChatGPT / Claude.ai Custom Connectors\n\nSettings → Connectors → Add custom connector → paste `https://profitpather.com/mcp` → approve OAuth.\n\n### No Profitpather account yet?\n\nSign up at [profitpather.com](https://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.\n\n---\n\n## Architecture\n\nProfitpather 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.\n\n```\nShopify Custom Pixel (storefront)\n       │\n       ▼\nCloudflare Worker  ───────►  D1 (per-merchant event store)\n       │                              ▲\n       ▼                              │\n   /mcp (MCP server)  ─── reads ──────┘\n       │\n       ▼\n  AI agent (Claude / ChatGPT / Cursor / your app)\n```\n\nAll 26 MCP tools are read-only against the merchant's own data — no cross-tenant access, no third-party data sharing.\n\n---\n\n## Discovery endpoints\n\nProfitpather publishes the full agentic-discovery surface:\n\n| Path | What it returns |\n|---|---|\n| `/.well-known/mcp/server-card.json` | MCP server card v1 (SEP-1649) |\n| `/.well-known/oauth-protected-resource` | OAuth 2.1 discovery (RFC 9728) |\n| `/.well-known/api-catalog` | RFC 9727 API catalogue |\n| `/.well-known/agent-skills/index.json` | Per-tool agent skills with SHA-256 digests (Cloudflare RFC v0.2.0) |\n| `/llms-full.txt` | Full Markdown documentation for LLM ingestion |\n| `/llms.txt` | LLM index |\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\nBuilt by [Boolsai](https://boolsai.ai) · Contact: [founder@boolsai.ai](mailto:founder@boolsai.ai)\n",
  "bytes": 6006,
  "sha": "4fe94d4203a7ea6b0a08879325b728358204b4d4ef6c463408faa98266c18952",
  "repo_slug": "profitpather/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_profitpather_analytics_caf27767/readme"
}