Skip to main content
Observal identifies MCP and tool activity from the session transcript recorded by each coding harness. It does not intercept MCP transport traffic.

What you get

When the harness records the relevant detail, session events can include:
  • Tool or MCP name
  • Tool input and result
  • Event ordering within the session
  • Harness, user, agent, and model attribution
  • Token totals and timing derived from the session
Coverage varies by harness because Observal can only index fields present in the local transcript or native message API. Transport-level latency and payload data are not synthesized when the harness does not record them.

Discover and install session hooks

scan is read-only. doctor patch installs supported session hooks or extensions and leaves every MCP command and remote URL unchanged. Scope hook installation to selected harnesses:
Restart the harness after hook changes, then run a coding session. If a hook was missed or the machine was offline, reconcile local session sources:

Query collected sessions

Open /traces in the web UI to filter sessions by harness, agent, user, model, and time range. Expand a session to inspect parsed prompts, responses, tool calls, tool results, and lifecycle events. The CLI can list recent sessions and unfold their events:

Caveats

  • MCP visibility depends on the harness transcript format.
  • Observal does not modify, proxy, or wrap MCP traffic.
  • Monetary cost and structured transport errors are unavailable unless the harness records equivalent session fields.

Next

Debug agent failures explains how to investigate failures using session evidence.