Name: agent-trace-brief
Price: 0.02 USDC
Availability: InStock

$ man agent-trace-brief

agentutility / agentops / agent-trace-brief

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

agentops

CATEGORY

uncategorized

STATUS

● live

NAME

agent-trace-brief — turns a raw agent execution trace into a readable agent trace summary: an ordered step-by-step account of what the agent did, where it br…

SYNOPSIS

POST https://x402.agentutility.ai/agent-trace-brief
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Turns a raw agent execution trace into a readable agent trace summary: an ordered step-by-step account of what the agent did, where it broke, and why. Built for tool call debugging when a run fails silently or an agent loops without explanation: send the trace array or log and get back failure points plus a root-cause hypothesis grounded only in what the trace actually shows, with anything it can't determine labeled unknown instead of guessed. Useful for agent run analysis after an incident, before a retry, or as part of a CI check on agent behavior. Use it as an agent debugging API, a trace root cause tool, or a post-mortem generator for agent pipelines.

INPUT — request schema

property	type	description	req?
trace	array \| string	The agent execution trace: either a JSON array of step/tool-call objects, or a plain-text log. Required. Serialized form capped at 40,000 chars.	required
focus	string	Optional hint telling the analyzer what to pay particular attention to, e.g. 'timeouts' or 'the retrieval step'. Max 300 chars.	optional

OUTPUT — response shape

field	type	description
brief	string	—
model	string	—
source	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/agent-trace-brief \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the agent-trace-brief tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: agentopsagenttracebriefagent-trace-brief
methods: POST
cluster: agentops
price: $0.02 USDC per call

ADJACENT — other endpoints in agentops

endpoint	description	price
eval-case-generate	Eval case generator for an agent or LLM task: describe the task and get back a draft llm eval dataset of {input, expected, rubric} cases…	$0.02
mcp-tool-risk-score	Heuristic MCP tool risk review for an MCP tool manifest before you wire it into an agent.	$0.02
tool-call-diff	Compare two agent run sequences and see how their tool calls differ.	$0.008