Tools

Every tool the Clamp MCP exposes. Read tools are available on the free plan. Write tools (create_funnel, create_alert) need a Pro or Growth plan. All tools accept an optional project_id and auto-resolve when your credential only has one project.

Common parameters

Most read tools accept the same filter set, so any answer can be scoped to any cohort.

• period — today, yesterday, 7d, 30d, 90d, or a custom range YYYY-MM-DD:YYYY-MM-DD. Defaults to 30d.
• pathname — filter to a single page
• referrer_host — filter by referring host (news.ycombinator.com)
• channel — direct, organic_search, organic_social, paid, email, referral
• country — ISO 3166-1 alpha-2 code (US, GB)
• device_type — desktop, mobile, tablet
• utm_source, utm_medium, utm_campaign, utm_content, utm_term
• limit — max rows (1-50, default 10)

Traffic

• get_overview — Pageviews, unique visitors, sessions, bounce rate, average session duration. Includes comparison to the previous period. Good first call.
• get_top_pages — Most visited pages ranked by pageviews. Pathname totals.
• get_top_referrers — Top referrer hostnames by unique visitors, with channel.
• get_timeseries — Event counts over time. Granularity auto-picks (hourly / daily / weekly / monthly) or override with granularity.
• get_current_visitors — Who’s on the site right now plus top pages, referrers, and countries in the last N minutes.

Audience

• get_countries — Visitor counts by country (ISO 3166-1 alpha-2).
• get_cities — Visitor counts by city, optionally filtered to one country.
• get_devices — Breakdown by device type, browser, browser version, OS, or OS version. Pick with group_by.

Events and revenue

• get_events — Custom event counts. Without name, returns all event names. With name, property, and value, filter or group by property. See Events.
• get_revenue — Sum Money-typed properties split by currency. Group by referrer, channel, country, device, pathname, or UTM. See Revenue.
• get_breakdown — Generic single-dimension breakdown. Use for entry_page, exit_page, region, and any UTM dimension. Prefer a specialised tool when one exists.
• compare_periods — Compare one metric between two time periods. Returns both values plus absolute and percent delta.

Sessions and engagement

• get_session_paths — Top (entry_page → exit_page) pairs, session counts, pages per session, average duration, bounce flag. See Engagement.
• get_page_engagement — Per-page engagement seconds and bounce rate from pageview_end beacons.

Funnels

• create_funnelPro — Create and immediately evaluate a funnel. Steps are event names or pageview:/path. 2-10 steps. See Funnels.
• get_funnel — Retrieve and re-evaluate a saved funnel. Accepts every common filter so you can see how conversion differs by cohort. Omit name to list all funnels.

Alerts

• create_alertPro — Trigger when a metric crosses a threshold. Metrics: pageviews, visitors, sessions, bounce_rate, avg_duration. Conditions: above, below, drops_by, increases_by. Evaluated on each MCP session connect.
• list_alerts — List every alert on the project with its id, metric, condition, threshold, and scope. Use before delete_alert.
• delete_alert — Delete an alert by id. Irreversible.

Meta

• list_projects — List every project this credential can access. Use to disambiguate when multiple projects exist.
• search_docs — Search the Clamp docs. Use when the user asks how to do something rather than what their data shows.