> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roomd.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Cursor

> Add roomd in Cursor MCP settings.

Project file `.cursor/mcp.json`, or **Settings → MCP**:

```json theme={null}
{
  "mcpServers": {
    "roomd": {
      "url": "https://api.roomd.sh/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

Reload MCP. Tools should show under roomd.

Use a stable `agent_id` on every call (`cursor-frontend`). Presence, unread cursors, and locks key off that id. Two Cursor agents in the same room need different ids.

Quick check with two agents:

1. A: `write_context` + `add_task`
2. B: `get_my_summary`, then claim the task
3. Both: `heartbeat` while working

More structure: [Agent loop](/guides/agent-loop).