PageLens Analytics

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Cookieless web analytics and AI Visibility: traffic, funnels, errors, and which AI bots read you.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "PageLens Analytics": {
      "url": "https://app.pagelens.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (23)

• list_sites read-only

  List the websites this key can access, with visitors in the last 24 hours.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_segments read-only

  Saved segments (named filter sets such as "Paid traffic" or "Mobile in Germany") that can be applied to any report with segment_id.

  Parameters:

  • site_id (required) — string — Site id from list_sites

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_overview read-only

  Headline metrics (visitors, sessions, pageviews, pages per session, bounce rate, average session duration) for a period, compared with the previous period of the same length, plus a time series.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • period — string — Time range (default 7d)
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters
  • include_series — boolean — Include the per-day/hour series (default true)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_breakdown read-only

  Top values of one dimension (pages, entry/exit pages, referrers, channels, UTM tags, countries, cities, browsers, OS, devices, languages, custom events, outbound links) with visitors and sessions.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • dimension (required) — string
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • limit — integer — Rows to return (default 10)
  • period — string — Time range (default 7d)
  • search — string — Only values containing this text
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_pages read-only

  Per-page metrics: visitors, pageviews, entries, bounce rate and time on page.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • limit — integer — Rows to return (default 10)
  • period — string — Time range (default 7d)
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_realtime read-only

  Visitors online right now (last 5 minutes) and what they are viewing.

  Parameters:

  • site_id (required) — string — Site id from list_sites

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_sessions read-only

  Recent sessions with entry/exit page, pages viewed, duration, source, location and device.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • kind — string
  • limit — integer — Rows to return (default 10)
  • period — string — Time range (default 7d)
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • user_id — string — Only sessions of this identified user
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_session read-only

  Every pageview and event in one session, in order.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • session_id (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_events read-only

  Custom events (sent with pagelens.track) and outbound clicks with counts and their properties.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • limit — integer — Rows to return (default 10)
  • period — string — Time range (default 7d)
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_errors read-only

  JavaScript errors grouped by message, with occurrences, affected sessions and pages.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • limit — integer — Rows to return (default 10)
  • period — string — Time range (default 7d)
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_web_vitals read-only

  Core Web Vitals from real visitors (LCP, INP, CLS, FCP, TTFB) at p50/p75/p90, overall and per page.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • period — string — Time range (default 7d)
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_journeys read-only

  Most common page-to-page paths visitors take.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • limit — integer — Rows to return (default 10)
  • period — string — Time range (default 7d)
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• run_funnel read-only

  Conversion funnel: how many sessions completed each step. Steps are pages (path, * wildcard allowed), custom event names, or a page scrolled at least `threshold` percent (type scroll). mode: ordered (default; other pages may come in between), strict (each step right after the previous one) or flexible (middle steps may be skipped). compare_previous adds the same funnel over the previous period.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • steps (required) — array
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • mode — string
  • period — string — Time range (default 7d)
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters
  • compare_previous — boolean

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_goals read-only

  Goals with conversions and conversion rate for the period, compared with the previous period.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • period — string — Time range (default 7d)
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_goal

  Create a goal that counts sessions visiting a page, firing a custom event, or scrolling a page at least `threshold` percent (type scroll). Needs a write key and member access or higher.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • type (required) — string
  • value (required) — string — Page path (wildcards allowed) or event name
  • name — string
  • threshold — integer — For scroll goals: percentage of the page scrolled, e.g. 75

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• add_annotation

  Mark a date on the charts (a release, a campaign, an outage). Needs a write key and member access or higher.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • date (required) — string — YYYY-MM-DD
  • text (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_retention read-only

  Cohort retention of identified users (pagelens.identify): share of each daily or weekly cohort that came back in later periods.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • unit — string
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_users read-only

  Users active in the period: identified users (with traits) and anonymous visitors, with sessions, pageviews and first source.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • kind — string
  • limit — integer — Rows to return (default 10)
  • period — string — Time range (default 7d)
  • search — string — Match user id, name or email
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_user read-only

  Profile of one identified user (traits, first/last seen, totals) and their sessions.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • user_id (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_search_console read-only

  Google Search Console data for the site (when connected): clicks, impressions, CTR and average position in Google Search, by query, page, country or device, plus a daily series. Data lags about 2 days.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • limit — integer — Rows to return (default 10)
  • period — string — Time range (default 7d)
  • search — string — Only queries (or pages) containing this text
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • dimension — string
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• delete_user_data destructive

  GDPR erasure: permanently delete all events, session replays and the profile of one user on a site. Needs a write key and admin access.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • user_id (required) — string — Identified user id, or "anon:<visitor_id>" for an anonymous visitor

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• get_bots_and_ai read-only

  Bot and AI traffic: AI crawlers (GPTBot, ClaudeBot…), AI assistants fetching pages, search engines, and human visits referred by AI assistants (ChatGPT, Perplexity, Claude…).

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • period — string — Time range (default 7d)
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_ai_visibility read-only

  How the site shows up in AI assistants, per AI company (OpenAI/ChatGPT, Anthropic/Claude, Perplexity, Google/Gemini…) and per page: crawler reads, live fetches while answering a person, human visits sent back, purchases and revenue, robots.txt access, and plain-language findings.

  Parameters:

  • site_id (required) — string — Site id from list_sites
  • to — string — End date YYYY-MM-DD, inclusive (default today)
  • from — string — Start date YYYY-MM-DD (overrides period)
  • period — string — Time range (default 7d)
  • filters — array — Optional filters "dimension:value" (is). Other operators go after the dimension: "page!:/x" is not, "page~:blog" contains, "page!~:blog" does not contain, "page^:/docs" starts with. Dimensions: page, title, hostname, referrer, channel, utm_source, utm_medium, utm_campaign, browser, os, device, screen, country (ISO code), city, language, event, tag
  • timezone — string — IANA timezone for days and hours, e.g. Europe/Berlin (default UTC)
  • segment_id — string — Apply a saved segment (see list_segments); combines with filters

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.