Zenovay Analytics

{
  "protocolVersion": "0.3.0",
  "name": "Zenovay Analytics",
  "description": "Zenovay is a privacy-first, real-time web analytics platform. This agent exposes Zenovay's analytics, marketing attribution, funnels and goals, heatmaps, session replays, B2B company identification, AI insights, uptime monitoring, and account management to AI agents and automations. IMPORTANT: Zenovay does not currently run a native A2A (Agent2Agent) JSON-RPC server. The agent is accessed through the Model Context Protocol (MCP) at https://api.zenovay.com/mcp (JSON-RPC 2.0 over the Streamable HTTP transport), authenticated with OAuth 2.1 (PKCE / S256; MCP access tokens are prefixed zvt_). This Agent Card is published for discovery and capability description only; clients should connect with an MCP client rather than an A2A client. The MCP server (name: zenovay-analytics, version 1.0.0) currently offers roughly 109 tools. See https://docs.zenovay.com/mcp for connection details.",
  "url": "https://api.zenovay.com/mcp",
  "preferredTransport": "JSONRPC",
  "supportedInterfaces": [
    {
      "url": "https://api.zenovay.com/mcp",
      "transport": "JSONRPC"
    }
  ],
  "version": "1.0.0",
  "documentationUrl": "https://docs.zenovay.com/mcp",
  "iconUrl": "https://zenovay.com/favicon.svg",
  "provider": {
    "organization": "Zenovay",
    "url": "https://zenovay.com"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/plain"
  ],
  "securitySchemes": {
    "oauth2": {
      "type": "oauth2",
      "description": "OAuth 2.1 authorization code flow with PKCE (S256 required). Issuer https://api.zenovay.com. Dynamic client registration (RFC 7591) and the device authorization grant are also supported. Access is granted to MCP access tokens (prefix zvt_); REST API keys are not used for the MCP interface.",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://api.zenovay.com/oauth/authorize",
          "tokenUrl": "https://api.zenovay.com/oauth/token",
          "refreshUrl": "https://api.zenovay.com/oauth/token",
          "scopes": {
            "read": "Read-only access to core resources",
            "write": "Create and modify core resources",
            "analytics:read": "Read web analytics (traffic, visitors, pages, sources, geography, devices)",
            "advanced:read": "Read advanced analytics (funnels, goals, heatmaps, session replays, B2B companies)",
            "advanced:write": "Create and manage advanced analytics objects (funnels, goals)",
            "ai_insights:read": "Read AI-generated insights, anomalies, and recommendations",
            "management:read": "Read account, website, and team management resources",
            "management:write": "Manage websites, team members, and account resources",
            "settings:read": "Read website and tracking settings",
            "settings:write": "Update website and tracking settings",
            "webhooks:read": "Read webhook configuration and delivery history",
            "webhooks:write": "Create and manage webhooks"
          }
        }
      }
    }
  },
  "security": [
    {
      "oauth2": [
        "read",
        "analytics:read",
        "advanced:read",
        "ai_insights:read",
        "management:read",
        "settings:read",
        "webhooks:read"
      ]
    }
  ],
  "skills": [
    {
      "id": "query-analytics",
      "name": "Query web analytics",
      "description": "Run analytics queries over a tracked website: pageviews, sessions, unique visitors, top pages, traffic sources, acquisition channels, geography, technology/device breakdowns, custom events, exit links, and live real-time visitor counts. Supports flexible date ranges and period comparisons.",
      "tags": [
        "analytics",
        "traffic",
        "visitors",
        "pageviews",
        "realtime",
        "sources",
        "geography",
        "devices"
      ],
      "examples": [
        "How many unique visitors did my site get in the last 7 days?",
        "What were my top 10 pages last month by pageviews?",
        "Compare traffic sources this week versus the previous week.",
        "How many people are on my site right now?"
      ]
    },
    {
      "id": "revenue-attribution",
      "name": "Revenue and marketing attribution",
      "description": "Analyze revenue and attribution: total and time-series revenue, attribution across acquisition channels, landing-page value, and per-visitor value. Helps answer which channels and pages drive the most value.",
      "tags": [
        "revenue",
        "attribution",
        "marketing",
        "channels",
        "roi",
        "value"
      ],
      "examples": [
        "Which acquisition channels drove the most revenue last quarter?",
        "What is the average value of a visitor from organic search?",
        "Which landing pages generate the highest value?"
      ]
    },
    {
      "id": "funnels-and-goals",
      "name": "Funnels and goals",
      "description": "Create, list, and analyze conversion funnels and goals: funnel step analysis, breakdowns, and health; goal definitions, completions, and toggling. Useful for conversion-rate optimization.",
      "tags": [
        "funnels",
        "goals",
        "conversion",
        "cro",
        "optimization"
      ],
      "examples": [
        "Where are users dropping off in my signup funnel?",
        "How many goal completions did the 'newsletter signup' goal record this month?",
        "Create a funnel for the checkout flow."
      ]
    },
    {
      "id": "heatmaps",
      "name": "Heatmaps",
      "description": "Retrieve heatmap data for a page, including click, scroll, and movement patterns, to understand how visitors engage with specific pages.",
      "tags": [
        "heatmaps",
        "clicks",
        "scroll",
        "engagement",
        "ux"
      ],
      "examples": [
        "Show me the click heatmap for my pricing page.",
        "How far down do visitors scroll on the homepage?"
      ]
    },
    {
      "id": "session-replays",
      "name": "Session replays",
      "description": "List and retrieve session replay recordings and frustration signals (such as rage clicks) to investigate individual visitor journeys and usability issues.",
      "tags": [
        "session-replay",
        "recordings",
        "ux",
        "frustration",
        "debugging"
      ],
      "examples": [
        "Show me recent session replays that include a frustration signal.",
        "List session recordings for visitors who reached the checkout page."
      ]
    },
    {
      "id": "b2b-company-identification",
      "name": "B2B company identification",
      "description": "Identify companies visiting a website and retrieve company-level details (such as location and page activity) to support B2B lead intelligence.",
      "tags": [
        "b2b",
        "companies",
        "leads",
        "firmographics",
        "intent"
      ],
      "examples": [
        "Which companies visited my site this week?",
        "Show details for the company that viewed the demo page."
      ]
    },
    {
      "id": "ai-insights",
      "name": "AI insights and recommendations",
      "description": "Surface AI-generated insights, automatic anomaly detection, daily movers, and actionable recommendations derived from a website's analytics data.",
      "tags": [
        "ai",
        "insights",
        "anomalies",
        "recommendations",
        "trends"
      ],
      "examples": [
        "What notable changes happened in my analytics yesterday?",
        "Are there any traffic anomalies I should know about?",
        "What does Zenovay recommend I focus on this week?"
      ]
    },
    {
      "id": "uptime-monitoring",
      "name": "Uptime monitoring",
      "description": "Check uptime status, history, and incidents, and manage uptime checks for monitored endpoints.",
      "tags": [
        "uptime",
        "monitoring",
        "incidents",
        "reliability",
        "availability"
      ],
      "examples": [
        "Is my site currently up?",
        "Show uptime incidents from the last 30 days."
      ]
    },
    {
      "id": "performance-and-errors",
      "name": "Performance and error tracking",
      "description": "Read Core Web Vitals and performance metrics, and inspect JavaScript errors and their details, to monitor site speed and front-end reliability.",
      "tags": [
        "performance",
        "web-vitals",
        "errors",
        "speed",
        "monitoring"
      ],
      "examples": [
        "What are my Core Web Vitals for the homepage?",
        "What JavaScript errors are most common on my site?"
      ]
    },
    {
      "id": "account-management",
      "name": "Account and settings management",
      "description": "Manage websites, tracking settings, goals, funnels, webhooks, team members, allowed domains, exclusions, and API keys. Includes reading and updating website name, domain, timezone, and tracking configuration.",
      "tags": [
        "management",
        "settings",
        "websites",
        "webhooks",
        "team",
        "api-keys"
      ],
      "examples": [
        "List all the websites in my account.",
        "Create a webhook that fires on new goal completions.",
        "Update the timezone for my website to Europe/Berlin."
      ]
    },
    {
      "id": "exports-and-reports",
      "name": "Data export and scheduled reports",
      "description": "Export analytics data and schedule recurring reports, including reviewing export history and report schedules.",
      "tags": [
        "export",
        "reports",
        "data",
        "scheduling"
      ],
      "examples": [
        "Export last month's analytics data.",
        "Schedule a weekly report to be generated every Monday."
      ]
    }
  ],
  "supportsAuthenticatedExtendedCard": false
}