Getting Started

Connect the VibesAnalytics MCP

VibesAnalytics runs as a hosted MCP server — there is nothing to install or download. You point your AI coding agent at one URL, authenticate with a workspace key, and your agent gets the full set of analytics tools (create a project, fetch the integration contract, validate tracking, connect providers, generate the SEO/GEO scaffold, and more).

1. Get a workspace API key

Sign in and open Setup to create a key — it looks like vt_live_… and scopes the agent to your workspace. (No account yet? It's free for up to 2 projects.)

Two ways to bootstrap, in order:

  1. You already have a key — paste it into the claude mcp add command below and you're done.
  2. No key yet — add the MCP with the placeholder key, then ask your agent to call vibes_register (it works without a key and returns a real vt_live_…). Put that key back into the Authorization header below and restart the agent so it's used on every later call.

2. Connect your agent (Claude Code)

Run this once in your terminal, then restart the agent:

claude mcp add --transport http vibesanalytics https://vibesanalytics.com/api/mcp \
  --header "Authorization: Bearer vt_live_YOUR_KEY"

Replace vt_live_YOUR_KEY with the key from step 1.

3. Connect your agent (Cursor / Windsurf / Claude Desktop)

Add this to your MCP config (e.g. ~/.cursor/mcp.json or your client's MCP settings):

{
  "mcpServers": {
    "vibesanalytics": {
      "type": "http",
      "url": "https://vibesanalytics.com/api/mcp",
      "headers": { "Authorization": "Bearer vt_live_YOUR_KEY" }
    }
  }
}

4. Hand it to your agent

Paste this prompt and let the agent drive the whole setup:

Use the vibesanalytics MCP. Register if I don't have a key, create a project for this app, fetch the integration contract, wire @vibetraker/js per the contract, then run validate-tracking until the required events report SEEN. Finally, generate the SEO/GEO scaffold for my domain.

Nothing to install

The MCP is a remote HTTP endpoint (https://vibesanalytics.com/api/mcp) — there is no package to download and nothing to keep updated; new tools appear automatically. A standalone npm package for offline/local use is coming at launch.

Next steps