Cursor integration.

Setup

There is no Cursor installer in the Empirical CLI today. Add Empirical as a custom remote MCP server directly in Cursor's config. Cursor reads `.cursor/mcp.json` in your project root, or `~/.cursor/mcp.json` for a global entry.

mcp.json example

Use a remote MCP server entry pointing to Empirical `/mcp` with a bearer token header. Refresh the token when it expires.

{
  "mcpServers": {
    "empirical": {
      "url": "https://empirical.gauzza.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:EMPIRICAL_ACCESS_TOKEN}"
      }
    }
  }
}

Runtime check

Reload MCP servers in Cursor, then run one memory query call and confirm tools are visible and returning results. This manual remote configuration is supported; the CLI installer does not currently set up Cursor automatically.

Support boundary: Use the hosted `/mcp` endpoint with OAuth. Do not paste a long-lived access token into a committed Cursor config file.