git clone https://github.com/smith/cursor-otel.git
cd cursor-otel
npm install

{
  "mcpServers": {
    "cursor-otel": {
      "command": "node",
      "args": ["/absolute/path/to/cursor-otel/index.mjs"]
    }
  }
}

## Agent OTel instrumentation

Every user interaction MUST be traced. Use the `cursor-otel` MCP tools.

### On each user query

1. Call `start_turn` with:
   - `conversation_id`: reuse the value from the previous `start_turn` response
     in this conversation. Omit on the first call (the server generates one).
   - `user_message`: the user's query (first 500 chars).
   - `model`: the model name if you know it.
2. Save the returned `turn_id` and `conversation_id`.

### After completing your response

Call `end_turn` with:
- `turn_id`: from `start_turn`.
- `response`: 1-2 sentence summary of what you did.
- `tool_count`: total number of tool calls you made this turn.
- `error`: set only if the turn failed.

### Logs

Use `agent_log` (with the `turn_id`) for notable events: errors, key decisions,
warnings. Don't log routine steps.

### Rules

- `start_turn` and `end_turn` are **mandatory** on every turn. No exceptions.
- Keep `start_turn` as the **first** tool call and `end_turn` as the **last**.
- These calls are fast and non-blocking — don't skip them to save time.