# EventDash MCP

Query EventDash analytics from Cursor, Claude Code, Codex, VS Code, and ChatGPT. Read-only.

Endpoint: https://www.eventda.sh/api/mcp

HTML docs: https://www.eventda.sh/docs/mcp
ChatGPT plugin: https://www.eventda.sh/docs/chatgpt.md
Long-form: https://www.eventda.sh/blog/ask-analytics-from-cursor

## Auth

- IDEs (Cursor, VS Code, Claude Desktop, Claude Code, Codex): add the endpoint and sign in with EventDash. Do not put a token in the config.
- Clients that cannot open a browser: `edt_` account token (Settings → API / MCP) or `edr_` app read key.
- `ed_` tracking keys: ingest only. They cannot call MCP.

Never put MCP tokens in the tracker snippet. Never paste secrets into chat.

## Connect (editors)

Cursor / VS Code `mcp.json`, then click Connect and sign in:

```json
{
  "mcpServers": {
    "eventdash": {
      "url": "https://www.eventda.sh/api/mcp"
    }
  }
}
```

Claude Code:

```bash
claude mcp add --transport http eventdash https://www.eventda.sh/api/mcp
```

Codex:

```bash
codex mcp add eventdash \
  --url https://www.eventda.sh/api/mcp
```

Or install the EventDash plugin in ChatGPT: https://chatgpt.com/plugins/plugin_asdk_app_6ace4208941081918144a70f2cbec3b8 (https://www.eventda.sh/docs/chatgpt.md).

stdio-only clients: `npx -y mcp-remote https://www.eventda.sh/api/mcp` (same sign-in).

Bearer fallback, only when the client cannot sign in. Keep `edt_` out of git:

```json
{
  "mcpServers": {
    "eventdash": {
      "url": "https://www.eventda.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer edt_xxx"
      }
    }
  }
}
```

Claude Code with a token:

```bash
claude mcp add --transport http eventdash https://www.eventda.sh/api/mcp \
  --header "Authorization: Bearer edt_xxx"
```

Codex with a token stored in `EVENTDASH_TOKEN`:

```bash
codex mcp add eventdash \
  --url https://www.eventda.sh/api/mcp \
  --bearer-token-env-var EVENTDASH_TOKEN
```

Tool reference: https://www.eventda.sh/docs/mcp/tools.md
For agents (install tracker): https://www.eventda.sh/docs/ai.md
