Tvix
SupportGo to Dashboard

Cursor

Connect Tvix to Cursor with hosted MCP and a Bearer agent token from the dashboard.

Cursor connects to Tvix through the hosted MCP server. Use the dashboard Agents → + Add Agent → Cursor flow for a ready-to-paste config.

Setup

Open the Agents wizard

In the Tvix dashboard, go to **Agents**, click **+ Add Agent**, and select **Cursor**.

Click Add to Cursor (one click)

The wizard mints an agent token and shows **Add to Cursor** — Cursor opens and asks to install the Tvix MCP server with the URL and token pre-filled. Also click **Add memory rule** so Cursor proactively answers from your Tvix memory and wiki (creates `.cursor/rules/tvix-memory.mdc` in your current project; move it to Cursor Settings → Rules → User Rules to apply everywhere).

Manual fallback: copy the MCP config

Prefer manual setup? The wizard also shows a JSON block. Paste it into Cursor MCP settings (Settings → MCP). Example shape:

```json
{
  "mcpServers": {
    "tvix": {
      "url": "https://api.tvix.ai/mcp",
      "headers": {
        "Authorization": "Bearer <your-agent-token>"
      }
    }
  }
}
```

Locally / Tvix for Mac, replace the URL with `http://127.0.0.1:8000/mcp` (not `api.tvix.ai`).

Reload MCP

Restart Cursor or reload MCP servers. You should see **Tvix** connected with tools such as `query_shared_brain`, `sync_memory_context`, `search_memory`, `capture_memory`, `search_wiki`, and `create_wiki_note`.

Required: enable automatic transcript sync (hooks)

From the Tvix repo run `scripts/install-tvix-hooks.sh`, then paste the Agents wizard **Cursor hooks.json** into `.cursor/hooks.json` (`TVIX_TOKEN` + `TVIX_API_URL` pre-filled; client forced to `cursor`). Cursor streams each prompt and response to Tvix via `POST /api/v1/agents/ingest` with Cursor provenance; Agents shows last sync. See [Shared agent memory](/features/shared-agent-memory).

Tools available

See Tvix MCP for the full tool and resource list. Resources use the execution-twin:// URI scheme today.

Troubleshooting

  • Confirm the Bearer token was copied fully and has not been revoked on the Agents page.
  • Production MCP is on api.tvix.ai, not a separate mcp.tvix.ai host.
  • On Tvix for Mac, pointing Cursor at cloud MCP will not see local memories — use http://127.0.0.1:8000/mcp.
  • If tools do not appear, reload MCP servers and check Cursor’s MCP logs.

Next Steps

Tvix MCP

Every MCP tool your agent can call.

Bring Your Context

Import chat history and connect apps.
Was this page helpful?