# Clamp Analytics

MCP server for Clamp—Web analytics for the agentic era, built for indie hackers and small teams shipping with AI.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add clamp/analytics

# Browse available tools
npx -y @smithery/cli@latest tool list clamp/analytics

# Get full schema for a tool
npx -y @smithery/cli@latest tool get clamp/analytics projects.list

# Call a tool
npx -y @smithery/cli@latest tool call clamp/analytics projects.list '{}'
```

## Direct MCP Connection

Endpoint: `https://clamp-analytics.run.tools`

## Tools (16)

- `projects.list` — List all Clamp projects this credential can access. Returns each project's id, name, and plan ('free', 'pro', or 'growt…
- `traffic.overview` — High-level snapshot of website traffic over a period: total pageviews, unique visitors, sessions, bounce rate (%), and …
- `events.list` — Get custom event counts. Without a `name` filter, returns every event name in the period with its total count and uniqu…
- `revenue.sum` — Sum revenue from Money-typed event properties. Returns per-currency totals, optionally grouped by a traffic dimension (…
- `traffic.timeseries` — Event counts over time as date buckets. Returns [{ date, count }] sorted ascending. Granularity is automatic based on p…
- `funnels.create` — Create and immediately evaluate a conversion funnel. A funnel measures how many unique visitors complete an ordered seq…
- `funnels.get` — Retrieve and re-evaluate a previously created funnel against current data for the specified period. Without a `name`, l…
- `alerts.create` — Create a metric alert that fires when a condition crosses its threshold. The alert monitors one metric (pageviews, visi…
- `alerts.list` — List all alerts configured for a project. Returns each alert's id (UUID), metric, condition, threshold, period, optiona…
- `alerts.delete` — Delete an alert by its id. Find the id by calling alerts.list first. The deletion is irreversible — there is no soft-de…
- `breakdown` — Aggregate visitors and pageviews grouped by a single dimension. The `dimension` parameter chooses what to group by — pa…
- `traffic.compare` — Compare one metric across two arbitrary periods side-by-side. Returns both period values plus absolute delta and percen…
- `sessions.paths` — Aggregate (entry_page → exit_page) session pairs. Returns the top pairs with how many sessions followed each path, aver…
- `pages.engagement` — Per-page metrics with a selectable detail level. The `view` parameter chooses what comes back:
- `traffic.live` — See who is on the site in the last N minutes. Returns the active visitor count plus top pages, top referrers, and top c…
- `docs.search` — Keyword-search the Clamp documentation index for setup, SDK, MCP, concepts, and skills pages. Returns ranked entries wi…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get clamp/analytics <tool-name>
```

## Prompts (5)

- `weekly_report` — Generate a weekly analytics report summarizing traffic, top pages, referral sources, and geographic breakdown. Call thi…
- `traffic_diagnosis` (period) — Diagnose why traffic changed. Investigates which channels, countries, devices, and pages are responsible for a traffic …
- `conversion_audit` (funnel_name) — Audit conversion performance by analyzing funnels and custom events. Identifies the biggest drop-off points and suggest…
- `channel_breakdown` (period) — Deep-dive into traffic channels to understand which sources drive real engagement vs just visits. Compares organic sear…
- `page_performance` (pathname, period) — Deep-dive into a specific page's performance: traffic trends, referral sources, device breakdown, and engagement metric…