{
  "name": "convalytics",
  "displayName": "Convalytics",
  "description": "Read-only analytics tools for AI assistants. Query top pages, top referrers, custom event counts, recent events, usage, and projects for your Convalytics account via Model Context Protocol. Requires a Convalytics API token generated at https://convalytics.dev/tokens and an active Solo or Pro plan.",
  "version": "1.0.0",
  "serverUrl": "https://api.convalytics.dev/mcp",
  "transport": "http",
  "documentationUrl": "https://convalytics.dev/mcp",
  "auth": {
    "type": "bearer",
    "scheme": "Bearer",
    "description": "Convalytics API token. Create at https://convalytics.dev/tokens, pass as Authorization: Bearer cnv_..."
  },
  "tools": [
    {
      "name": "list_projects",
      "description": "List all Convalytics projects on the team this token belongs to."
    },
    {
      "name": "get_usage",
      "description": "Return the current month's custom-event usage, monthly quota, retention days, and plan name for the team."
    },
    {
      "name": "top_pages",
      "description": "Return the top pages for a specific project, ranked by views in a time window. Takes `project` (name or id)."
    },
    {
      "name": "top_referrers",
      "description": "Return the top referring hosts for a specific project, ranked by visits, includes (direct). Takes `project`."
    },
    {
      "name": "pageviews_count",
      "description": "Count page views for a specific project in a time window (web-traffic, separate from custom events). Takes `project`."
    },
    {
      "name": "events_count",
      "description": "Count CUSTOM product events for a specific project (not page views — those are in a separate table; use pageviews_count). Takes `project`."
    },
    {
      "name": "recent_events",
      "description": "Return the most recent custom events for a specific project; PII is redacted by default. Takes `project`. Optional `user` filter."
    },
    {
      "name": "user_activity",
      "description": "Composite per-user snapshot: identity block, totals, top pages, top event names, recent events. Matches by userEmail (case-insensitive) or visitorId. Takes `project` and `user`."
    },
    {
      "name": "weekly_digest",
      "description": "Composite snapshot over a lookback window: visitors, pageviews, sessions, bounce rate, session duration, top 5 pages, top 5 referrers, top 5 events. Includes period-over-period comparison. Takes `project`, optional `days` (default 7) and `compare` (default true)."
    }
  ],
  "contact": {
    "email": "hello@convalytics.dev",
    "url": "https://convalytics.dev/contact"
  },
  "publisher": {
    "name": "Tethered Software Inc.",
    "url": "https://convalytics.dev/about"
  }
}