Read-only search for retained AgentGuard trace summaries from the AgentGuard Read API. Requires AGENTGUARD_API_KEY with read access; create keys in the AgentGuard dashboard. Returns JSON with a traces array, newest traces first when the API supports ordering; items include trace_id, service, root_name, event_count, error_count, duration_ms, started_at, API key metadata, and total_cost when available. Defaults to a small page, accepts offset pagination, exact service filtering, and ISO 8601 since/until bounds. Use this to find candidate trace_id values; use get_trace for the full event tree of one trace or get_trace_decisions for decision.* events from a known trace.

Get the full event tree for a specific trace by its trace ID. Shows all spans, tool calls, LLM calls, guard triggers, and errors.

Extract normalized decision.* events from one trace. Use this when a workflow includes proposal, override, approval, or binding steps.

Get recent guard alerts (loop detection, budget exceeded) and errors. Useful for checking if your agents are hitting safety limits.

Check your current event quota usage and plan limits. Shows event count vs limit, retention period, and plan details.

Get cost breakdown for the current month: total spend, cost by model, and estimated savings from guard interventions.

Quick pass/fail budget health check. Combines usage quota and cost data to give a summary of whether you're within safe operating limits.