Zenovay Analytics
Connect AI assistants to your Zenovay web analytics.
Что умеет
- Query Analytics: Ask a natural language question about your website analytics. Supports questions like "How many visitors this week?", "What are my top pages?", "Where is my traffic coming from?". Thi
- Get Visitors: Get visitor statistics for a website over a given time range. Returns total visitors, unique visitors, page views, bounce rate, and average session duration. Optionally compares with the
- Get Top Pages: Get the most visited pages for a website, ranked by visitor count.
Какие данные видит
Нужен ли аккаунт
Не нужен: сервер работает без входа
Connect AI assistants to your Zenovay web analytics. Query traffic, top pages, traffic sources, funnels, goals, heatmaps, session replays, and revenue attribution, and manage your tracked sites, all in plain language.
Zenovay is a real-time, privacy-first analytics platform. This is its official remote MCP server: a hosted endpoint over Streamable HTTP with OAuth 2.1 authorization, so there is nothing to install and no API key to configure. Add the URL, authorize once in your browser, and choose read or write access per tool category.
Works with Claude, Cursor, VS Code, Windsurf, and any MCP-compatible client. Available on every Zenovay plan, including Free. Learn more at https://docs.zenovay.com/mcp
Список инструментов сервера (60)
Технические названия из tools/list. Нужны только разработчикам.
| query_analytics | Ask a natural language question about your website analytics. Supports questions like "How many visitors this week?", "What are my top pages?", "Where is my traffic coming from?". This is the most flexible analytics tool — use it when other specific tools do not fit. |
| get_visitors | Get visitor statistics for a website over a given time range. Returns total visitors, unique visitors, page views, bounce rate, and average session duration. Optionally compares with the previous equivalent period. |
| get_top_pages | Get the most visited pages for a website, ranked by visitor count. |
| get_traffic_sources | Get traffic sources (referrers) for a website, showing where visitors come from. Direct visits (no referrer) are labeled as "Direct". |
| get_geographic_data | Get geographic breakdown of visitors by country, with optional city-level detail. |
| get_technology_breakdown | Get a breakdown of visitor technology: devices (desktop/mobile/tablet), browsers, and operating systems. |
| get_realtime_visitors | Get currently active visitors on the website (visited within the last 5 minutes). |
| compare_periods | Compare analytics metrics between two time periods. Shows visitors, page views, bounce rate, and percentage changes between the current and comparison period. |
| get_acquisition_channels | Get acquisition breakdown of visitors grouped by a dimension — channel (default), UTM source/medium/campaign, or landing page. Returns each value with its visitor count and share of total. Useful for understanding which channels and campaigns acquire the most traffic. |
| get_funnel_analysis | Get funnel analysis data. Without a funnel_id, lists all funnels for the website. With a funnel_id, returns detailed step-by-step conversion data including visitor counts and conversion rates per step. |
| get_goals | Get all active goals for a website with completion counts and conversion rates within the specified time range. |
| get_session_replays | List session replay recordings for a website. Returns session metadata (not raw replay events). Filter by device type or country. |
| get_heatmap_data | List pages with heatmap interaction data. Optionally filter to a specific page URL to see detailed interaction counts. |
| get_errors | Get tracked JavaScript errors for a website. Filter by status (open, resolved, ignored) to focus on actionable issues. |
| get_b2b_companies | Identify B2B companies visiting your website using reverse IP lookup and enrichment data. Filter by industry or minimum visit count. |
| get_revenue | Get revenue analytics with totals and breakdowns. Group revenue data by day, week, month, or traffic source to understand revenue trends. |
| get_performance_metrics | Get Core Web Vitals and performance metrics (LCP, CLS, INP, FCP, TTFB) with percentile breakdowns. Optionally filter to a specific page URL. Also exposes a TTFB phase breakdown (DNS, TCP, TLS, request, transfer percentiles) and the worst-offending element selector per route (LCP/INP/CLS); these are forward-only and may be null while the attribution pipeline is still collecting. |
| get_retention_data | Get cohort-based retention analysis data. Groups visitors by their first visit period and tracks how many return in subsequent periods. Requires Pro plan or higher. |
| get_user_profiles | Get identified user profiles for a website. Returns visitor profiles with session counts, page views, revenue, and identity data (email, name). Optionally search by email or name. |
| get_attribution | Get first-touch or last-touch channel attribution for conversions. Shows which marketing channels drive the most conversions and revenue. |
| get_funnel_health | Get funnel health analysis with drop-off cause breakdown by device, browser, country, and source for each step. Identifies the worst drop-off point and generates an AI narrative with actionable insights. |
| get_goal_completions | Get per-goal completion events over time as a daily timeline (not just the summary counts get_goals returns). Without a goal_id, returns the timeline aggregated across all goals. With a goal_id, returns the timeline for that specific goal. Each timeline point includes the date, number of completions, unique converting visitors, and total completion value for that day. |
| get_frustration_signals | Get user-frustration signals (rage clicks, dead clicks, form frustrations, form abandonments, etc.) for a website. Returns summary stats (total events, affected sessions/visitors, breakdown by frustration type) plus the worst-offending pages / hotspots over a time range. |
| get_custom_events | Get custom events tracked for a website over a time range. Returns the top custom event names ranked by occurrence count. Optionally filter to a single event_name to get a breakdown of its event properties (the most common property values). Custom events are rows in user_events with event_type = "custom". |
| get_error_details | Drill into ONE JavaScript error group, identified by its error_id (the id field from get_errors) or its fingerprint. Returns the error group metadata, occurrence totals, a frequency trend over time, the top pages where it occurred, a browser/OS/device breakdown, and the most recent occurrences. Pass error_id (preferred) OR fingerprint — at least one is required in addition to website_id. |
| get_daily_movers | Get the metrics that moved the most versus the prior period — "what changed today/this week". Returns each mover with its baseline vs current value, percent delta, direction, magnitude score, an AI briefing summary, and ranked candidate causes (proximity/overlap/magnitude/novelty scored). Requires Pro plan or higher. |
| get_funnel_breakdown | Get per-step funnel counts split by a dimension (device, browser, country, or source). For each funnel step, returns the number of visitors that entered, broken down by the chosen dimension with counts and percentages. Read-only. |
| get_exit_links | Get the top outbound / exit links for a website ranked by click count. Returns each destination URL with click totals, unique source pages, top device/browser/country, and first/last clicked timestamps, plus a summary with total exit clicks, unique destinations, and the top exit domains. |
| get_visitor_value | Get the visitor value-score distribution (0-100 bucketed into 5 tiers) plus average value, high-value visitor share, and value-by-segment breakdowns (top countries, operating systems, browsers, and device types ranked by average value score). Useful for understanding which visitor segments are most valuable. |
| get_landing_page_value | Rank landing (entry) pages by visitor count and average attributed value score. Surfaces which entry pages bring in the most valuable traffic. |
| get_user_timeline | Get the chronological event timeline for a single visitor on a website, plus their identified profile (email, name, revenue) when available. Events include page views, custom events, and payments with amounts. |
| get_segments | List the workspace's saved visitor segments for this website. Returns each segment's name, description, and filter definition. |
| get_experiment_results | Get per-variant conversion results for a single A/B experiment (sample size, conversions, conversion rate per variant). The experiment must belong to the given website. |
| list_experiments | List A/B experiments for a website. Optionally filter by status (draft, running, paused, completed, archived). |
| get_company_details | Get enrichment details for a single B2B company (name, domain, industry, size, employee count, revenue range, location, technologies) along with its visit history on the given website. |
| get_golden_path_status | Get the website's Golden-Path monitor: its active definition plus recent run history (pass/fail status, failure class, duration). Read-only — a Golden-Path Monitor is a business guardrail, not an uptime guarantee or a reliability certification. |
| get_insights | Retrieve AI-generated insights for a website. Returns actionable insights with severity levels and summaries. Use this to understand what the AI has flagged about website performance, traffic patterns, and user behavior. |
| get_anomalies | Retrieve detected anomalies for a website. Anomalies are unusual deviations in metrics like visitors, bounce rate, page views, etc. Each anomaly includes expected vs actual values and the percentage deviation. |
| get_weekly_digest | Generate a comprehensive weekly performance digest for a website. Compares this week vs last week across key metrics (visitors, pageviews, bounce rate, session duration) and includes top pages and top countries. No AI service required — computed from analytics data. |
| get_recommendations | Retrieve AI-generated recommendations for improving website performance. Recommendations are categorized by focus area (growth, optimization, engagement, revenue, performance) and prioritized by impact. |
| list_websites | List all websites accessible by the current API key. Returns website details including domain, tracking code, and active status. Full-access keys see all team websites; site-scoped keys see only their assigned website. |
| create_website | Create a new website/domain to track with Zenovay analytics. Returns the tracking code needed to install the tracking script. Requires read-write API key with full_access permission. |
| delete_website | Delete a tracked website/domain. This permanently removes the website and all associated tracking data. Requires read-write API key with full_access permission. |
| create_feature_flag | Create a FEATURE FLAG on a website for a gradual rollout / targeted release. Provide the flag name; optionally a rollout percentage (0-100), target country codes (2-letter ISO, e.g. ["CH","DE"]), and target devices (any of "desktop","mobile","tablet"). The flag is enabled on creation. Example: "a flag called testing, 60% rollout, just CH and DE, desktop only". |
| set_public_dashboard_tabs | Control which tabs are visible on a website's PUBLIC dashboard. Provide visible_tabs = the tabs to SHOW; every other tab is hidden. Valid tab keys: revenue, sessions, heatmaps, errors, insights, companies. Example: visible_tabs=["revenue"] shows ONLY Revenue and hides the rest. |
| create_goal | Create a custom goal for a website. Goals track conversions based on URL matches, element clicks, or custom events. For url_match goals, provide url_pattern and optionally url_match_type. For element_click goals, provide css_selector. For custom_event goals, provide event_name. |
| manage_funnel | Create or update a conversion funnel for a website. A funnel consists of 2-10 ordered steps that track user progression through a flow. Provide funnel_id to update an existing funnel, or omit it to create a new one. |
| create_annotation | Create a chart annotation (timeline marker) for a website. Annotations mark notable events — deploys, releases, marketing campaigns, incidents, or custom notes — on the analytics charts so you can correlate them with traffic and conversion changes. Free plans are limited to 10 annotations/month; identical annotations within 5 minutes are deduplicated. |
| export_data | Export analytics data for a website in JSON or CSV format. Returns daily aggregated metrics for the specified time range. Available metrics: visitors, pageviews, unique_visitors, bounce_rate, avg_session_duration. |
| get_api_usage | Get current API key usage information including monthly request counts, MCP daily query quota, and subscription tier. Useful for monitoring usage and checking remaining quota before running expensive queries. |
| get_website_settings | Get all settings for a website including tracking configuration, public dashboard status, timezone, and advanced options like cookieless mode and heartbeat. |
| update_website_settings | Update website tracking settings. Only provided fields are updated; unset fields remain unchanged. Settings include silent_mode, debug_mode, cookieless_mode, enable_heartbeat, track_outbound_links, session_timeout, and allow_localhost. |
| toggle_public_dashboard | Enable or disable the public dashboard for a website. When enabled, returns the public share URL that anyone can access without authentication. |
| toggle_cookieless_tracking | Enable or disable cookieless tracking for a website. When enabled, tracking uses server-side hashed identifiers instead of cookies or localStorage, making it fully GDPR-compliant without a cookie banner. |
| toggle_widgets | Enable or disable embeddable public widgets (e.g. live-visitor / stats badges) for a website. When disabled, existing widget embeds stop returning data. |
| get_tracking_code | Get the tracking code for a website along with multiple installation options: standard script tag, first-party proxy, and async loading. |
| regenerate_tracking_code | Generate a new tracking code for a website. The old code will stop working immediately. You will need to update the tracking script on your website with the new code. |
| list_goals | List all custom goals for a website, including their type, status, and completion counts. |
| update_goal | Update an existing custom goal. Only provided fields are updated. |
| delete_goal | Permanently delete a custom goal from a website. This also removes all associated completion data. |