# Clamp

> Product analytics that gives you the answer, not just the chart. Install the SDK to collect data, connect the MCP server to ask your AI agent questions about it, and add the analytics skills so the agent reads it like a senior analyst. Full coverage for acquisition, conversion, retention, and revenue — without enterprise complexity.

## Quick start

- [Quick start](https://clamp.sh/docs): Two pasteable agent prompts (basic install and full SaaS end-to-end), plus a 5-step manual setup. SDK + MCP + Skills.

## SDK

- [SDK overview](https://clamp.sh/docs/sdk): Install snippets, quickstart, npm version. Links to tracking, server, extensions, and API reference.
- [SDK tracking](https://clamp.sh/docs/sdk/tracking): What's captured automatically, custom events, typed events, Money properties, property limits. Includes an agent prompt to add 3-5 high-signal track() calls.
- [SDK server-side](https://clamp.sh/docs/sdk/server): Track from Node.js. Link browser and server events with an anonymous ID. Authoritative revenue from webhooks. Includes a Stripe-revenue agent prompt.
- [SDK extensions overview](https://clamp.sh/docs/sdk/extensions): Catalog of outbound links, downloads, 404 detection, data attributes, web vitals. Path exclusions and debug mode. Each extension has its own subpage.
- [Outbound links extension](https://clamp.sh/docs/sdk/extensions/outbound-links): Auto-track clicks on links to a different hostname.
- [File downloads extension](https://clamp.sh/docs/sdk/extensions/downloads): Auto-track clicks on links to known file extensions. Default extension list, override via { extensions: [...] }.
- [404 detection extension](https://clamp.sh/docs/sdk/extensions/not-found): Detect 404 pages in SPAs by matching document.title.
- [Data-attributes extension](https://clamp.sh/docs/sdk/extensions/data-attributes): Click tracking from HTML with data-clamp-event. No JS required. Money shorthand.
- [Web Vitals extension](https://clamp.sh/docs/sdk/extensions/web-vitals): LCP, CLS, INP, FCP, TTFB capture. Peer dependency, sampling, per-page analysis.
- [Section views extension](https://clamp.sh/docs/sdk/extensions/section-views): Fires `section_viewed` once per session when a `data-clamp-section="..."` element scrolls into view. Engagement signal for which page sections actually get seen.
- [SDK API reference](https://clamp.sh/docs/sdk/reference): Every export from browser, React, and server packages. Types and script-tag build. Includes excludePaths option.

## MCP server

- [MCP overview](https://clamp.sh/docs/mcp): What the MCP server does, remote vs stdio, and links to setup, tools, prompts, examples.
- [MCP setup](https://clamp.sh/docs/mcp/setup): One-click install the remote MCP in Cursor, VS Code, Claude Code, Claude Desktop. OAuth sign-in on first use.
- [MCP tools reference](https://clamp.sh/docs/mcp/tools): Every tool grouped by what it does: traffic, audience, events, sessions, funnels, alerts, meta.
- [MCP prompts](https://clamp.sh/docs/mcp/prompts): Pre-built analytics workflows: weekly report, traffic diagnosis, conversion audit, channel breakdown, page performance.
- [MCP examples](https://clamp.sh/docs/mcp/examples): Real questions and the tool calls they produce for traffic, revenue, engagement, funnels.
- [MCP self-hosting](https://clamp.sh/docs/mcp/self-hosting): Run the Clamp MCP locally over stdio with a project API key.

## Analytics skills

- [Analytics skills](https://clamp.sh/docs/skills): Six model-invoked agent skills (analytics-profile-setup, analytics-diagnostic-method, traffic-change-diagnosis, channel-and-funnel-quality, metric-context-and-benchmarks, event-schema-author). Calibrated benchmarks instead of generic averages.

## Event Schema

- [Event Schema](https://clamp.sh/docs/event-schema): A portable, typed YAML format for declaring product analytics events. Authored once in `event-schema.yaml`, the `@clamp-sh/event-schema` CLI validates it and generates a `.d.ts` so `track()` calls are autocompleted and type-checked at build time. Spec and CLI live at github.com/clamp-sh/event-schema.

## Concepts

- [Events](https://clamp.sh/docs/concepts/events): Pageviews, custom events, event shape, property rules, naming.
- [Properties](https://clamp.sh/docs/concepts/properties): Property shape, limits, typed events, Money values, naming conventions.
- [Revenue](https://clamp.sh/docs/concepts/revenue): Attach Money-typed properties and query revenue by source, country, campaign with revenue.sum.
- [Engagement and sessions](https://clamp.sh/docs/concepts/engagement): How visible time is measured, pageview_end beacon, bounce rate.
- [Funnels](https://clamp.sh/docs/concepts/funnels): Create and evaluate multi-step conversion funnels.

## Install guides

- [Install guides](https://clamp.sh/docs/install): Framework-specific install guides.
- [Next.js install](https://clamp.sh/docs/install/nextjs): App Router and Pages Router setup.
- [Vite + React install](https://clamp.sh/docs/install/vite-react): React SPA setup with Vite.
- [SvelteKit install](https://clamp.sh/docs/install/sveltekit): SvelteKit setup.
- [Nuxt install](https://clamp.sh/docs/install/nuxt): Nuxt 3 setup.
- [Astro install](https://clamp.sh/docs/install/astro): Astro setup.

## Writing

- [Blog](https://clamp.sh/blog): Notes from the build — agentic analytics, MCP, and how Clamp is designed.
- [Analytics should answer, not display](https://clamp.sh/blog/analytics-should-answer-not-display): Why dashboards are a compromise from an era when software couldn't answer questions over arbitrary data, and what changes when an LLM + MCP can. Cites Stephen Few's 2006 dashboard definition, Gartner's 25-year BI adoption ceiling, Atlan's Tableau-sprawl analysis, Benn Stancil on BI's missed promise.
- [How we taught Claude Code to diagnose analytics like a senior analyst](https://clamp.sh/blog/how-we-taught-claude-code-to-diagnose-analytics): Most AI analytics tools give listicles where a senior analyst gives a diagnosis. Walks the methodology Skills encode (MECE trees, sample-size discipline, the quality matrix, GA4-vs-UA bounce, fingerprint library) with two worked examples — a phantom traffic drop that's actually launch decay, and a 3.8% funnel that's actually fine once mix-shift is split out.
- [Why your funnel conversion rate is lying to you](https://clamp.sh/blog/funnel-conversion-rate-is-lying-to-you): A founder's pricing-page redesign moved funnel conversion rate from 8% to 15% — every step better, paid signups nearly doubled — but revenue fell because every individual visitor segment was actually converting worse. Walks Simpson's paradox in funnel reports: the false-positive (team's case) and false-negative (mirror) directions, the rule that catches both (no top-line move is real until each segment moves with it), and how the channel-and-funnel-quality skill enforces the check automatically.

## Other

- [Pricing](https://clamp.sh/pricing): Free, Pro, Growth tiers. Free up to 100K events/month. Machine-readable plan data at https://clamp.sh/pricing.md.
- [Changelog](https://clamp.sh/changelog): What shipped this week.
- [Feed](https://clamp.sh/blog/feed.xml): RSS feed of writing.