Back to Convalytics

Card snapshot

convalytics.dev · 2026-05-18 15:15:11 UTC · 39e7ed471fe38435e17d50a354472f7be694132f815dbe329091bd4521475157

This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.

{
  "name": "Convalytics",
  "description": "Free web and product analytics for Convex apps. Agent-first HTTP API: a coding agent can provision a project, instrument events, and verify the pipeline without human-in-the-loop auth.",
  "url": "https://api.convalytics.dev",
  "documentationUrl": "https://convalytics.dev/llms-full.txt",
  "provider": {
    "organization": "Convalytics",
    "url": "https://convalytics.dev"
  },
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "authentication": {
    "schemes": [
      "writeKey"
    ],
    "description": "Public write key passed in the request body. Scoped to a single project, cannot read data, safe to ship in client code. See https://convalytics.dev/llms-full.txt for the provision flow."
  },
  "skills": [
    {
      "id": "provision_project",
      "name": "Provision analytics project",
      "description": "Create an unclaimed project and return a write key plus a claim URL for the human to link it to their account later. No auth required.",
      "tags": [
        "analytics",
        "provision",
        "setup"
      ],
      "examples": [
        "Set up Convalytics for this Convex app",
        "Get a write key to start tracking events"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "ingest_event",
      "name": "Record event or page view",
      "description": "Log a page view (free, unquota'd) or a custom product event with props for a project identified by write key.",
      "tags": [
        "analytics",
        "events",
        "tracking"
      ],
      "examples": [
        "Track a signup event for user_123",
        "Record a page view for the pricing page"
      ]
    },
    {
      "id": "ingest_batch",
      "name": "Batch ingest up to 100 events",
      "description": "High-volume event ingestion with per-event results in the same order as the input.",
      "tags": [
        "analytics",
        "events",
        "batch"
      ]
    },
    {
      "id": "verify_write_key",
      "name": "Verify write key",
      "description": "Confirm a write key is valid and fetch a snapshot of recent ingestion activity, useful for agents verifying their setup end-to-end.",
      "tags": [
        "analytics",
        "verification"
      ]
    },
    {
      "id": "query_analytics_mcp",
      "name": "Query analytics via MCP",
      "description": "Convalytics exposes a Model Context Protocol server for AI assistants (Claude Desktop, Claude Code, Cursor, Windsurf). Nine read-only tools cover traffic, custom events, per-user activity, and a period-over-period digest. Six funnel tools list/read/compute saved conversion funnels; with a write-scoped token, agents can also create/update/delete funnels. Uses a separate auth model (team-scoped API token with read or write scope) and is gated to paid plans. See https://convalytics.dev/.well-known/mcp/server-card.json for the capability list and https://convalytics.dev/mcp for install instructions.",
      "tags": [
        "analytics",
        "mcp",
        "query",
        "funnels",
        "read",
        "write"
      ],
      "examples": [
        "What are the top 10 pages on my site this week?",
        "How is dan@example.com using my app?",
        "Give me a weekly digest of my project with period-over-period comparison",
        "Compute the Signup funnel for the last 7 days and show step-by-step conversion",
        "Create a funnel: pageview /pricing, then event signup_completed"
      ]
    }
  ]
}