Connect Tracwell to your agent

Add https://tracwell.app/mcp to an OAuth-capable assistant, sign in to Tracwell, and choose websites and permission. Only workspace owners can approve connections. Manage connections in Settings → Developer.

For clients configured with an API key, create a key in Settings → Developer and use the examples below.

Add the server from Settings → Developer servers and choose Streamable HTTP, or add this to ~/.codex/config.toml. Set TRACWELL_MCP_KEY before starting Codex.

[mcp_servers.tracwell]
url = "https://tracwell.app/mcp"
bearer_token_env_var = "TRACWELL_MCP_KEY"

Add Tracwell at user scope, then run claude mcp get tracwell to verify the connection.

claude mcp add --transport http --scope user tracwell \
  https://tracwell.app/mcp \
  --header "Authorization: Bearer YOUR_READ_ONLY_KEY"

Save this as ~/.cursor/mcp.json for every project or .cursor/mcp.json for one workspace.

{
  "mcpServers": {
    "tracwell": {
      "url": "https://tracwell.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_READ_ONLY_KEY"
      }
    }
  }
}

Add this to .vscode/mcp.json, or run MCP: Open User Configuration for a global setup.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "tracwell-mcp-key",
      "description": "Tracwell MCP read-only key",
      "password": true
    }
  ],
  "servers": {
    "tracwell": {
      "type": "http",
      "url": "https://tracwell.app/mcp",
      "headers": {
        "Authorization": "Bearer ${input:tracwell-mcp-key}"
      }
    }
  }
}

Start with analytics_projects, discover event names with analytics_events, and inspect typed property values with analytics_event_detail. Follow pagination cursors to discover every saved definition or observed event name.

Preview a goal or funnel before saving it. Write keys expose only goal/funnel create and update commands. Every write requires a UUID requestId; reuse it with identical input after a timeout. Updates require the current expectedRevision. Read again after a revision conflict.

Conversion reports explain their denominator, identity and time window. They count anonymous visitors; Private mode estimates visitors daily. Sessions are recorded visits. Report links preserve the website, definition, exact timestamps and timezone.

Every key can list chart notes with notes_list; write keys and write-approved OAuth connections can add one with note_create. To mark deploys from CI with a notes-only key, see Chart notes.