MCP server

Give Claude, Cursor, or Codex read-only access to the same aggregates the dashboard shows.

@vector5/mcp is a stdio MCP server. Six tools, all reads, all aggregates. It never sees event rows and it cannot ingest.

Install

.mcp.json

{
  "mcpServers": {
    "vector5": {
      "command": "npx",
      "args": ["@vector5/mcp"],
      "env": {
        "V5_API_URL": "https://analytics.example.com",
        "V5_API_KEY": "v5_live_…",
        "V5_SITE_ID": "example.com"
      }
    }
  }
}

Cursor reads .mcp.json from the project root. Claude Desktop uses claude_desktop_config.json. Codex uses its MCP settings panel. Cursor setup.

Environment

Var	Required	Notes
`V5_API_URL`	no	Default `http://localhost:8080`
`V5_API_KEY`	yes in prod	Bearer key from Settings
`V5_SITE_ID`	yes	Site domain or id the API expects

Tools

Each tool accepts days and actor. Details: Tools reference.

Tool	Upstream
`query_stats`	`GET /api/sites/{id}/stats`
`top_pages`	`GET /api/sites/{id}/breakdown?field=page`
`sources`	`GET /api/sites/{id}/breakdown?field=source`
`ai_traffic`	`GET /api/sites/{id}/ai`
`goals`	`GET /api/sites/{id}/goals`
`insights`	`GET /api/sites/{id}/insights`