MCP Tools

Start the server:

cargo run -p auditaur-cli -- mcp

Or with a locally installed binary:

auditaur mcp

Example MCP client config:

{
  "mcpServers": {
    "auditaur": {
      "command": "auditaur",
      "args": ["mcp"]
    }
  }
}

For source checkout usage:

{
  "mcpServers": {
    "auditaur": {
      "command": "cargo",
      "args": ["run", "-p", "auditaur-cli", "--", "mcp"],
      "cwd": "C:\\path\\to\\auditaur"
    }
  }
}

The server speaks stdio JSON-RPC and does not write non-MCP content to stdout. Tool responses are JSON serialized as MCP text content and are bounded.

Tool	Required arguments	Notes
doctor	none	Accepts optional db.
get_health	none	Reads local discovery files and reports heartbeat, database/schema, and collector capability health.
list_pending_human_gates	none	Lists pending, unexpired drill run human gate requests published beside pinned session databases for agent/UI approval. Run the MCP server with the same Auditaur data directory as the drill.
respond_human_gate	requestId	Answers a pending gate. Optional choiceId, inputs, and responder are recorded; inputs can be an object keyed by input id.
list_sessions	none	Optional db; uses discovery when omitted.
list_logs	none	Optional db, sessionId, traceId, limit.
list_errors	none	Optional db, sessionId, traceId, limit. Use the CLI exceptions command when grouped issue-ready exception reports are needed.
list_traces	none	Optional db, sessionId, limit.
get_trace	traceId	Optional db; returns spans, logs, frontend errors, IPC calls, events, and window rows.
get_related_telemetry	none	Optional db, sessionId, traceId, windowLabel, time bounds, and limit; returns correlated spans, logs, frontend errors, IPC calls, events, and windows.
explain_recent_activity	none	Optional db, sessionId, traceId, windowLabel, sinceSeconds, time bounds, and limit; returns counts and likely failure findings.
explain_failed_ipc	none	Optional db, sessionId, traceId, windowLabel, time bounds, and limit; summarizes failed IPC and related telemetry for the latest traced failure.
list_apps	none	Reads local discovery files.
list_ipc_calls	none	Optional db, sessionId, traceId, limit.
list_events	none	Optional db, sessionId, traceId, limit.
list_windows	none	Optional db, sessionId, limit; returns latest stored window states.

For the dogfood app, tools can use discovery automatically while exactly one active readable session is present. Pass db when multiple sessions are active.