Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man agent-run-review

/agent-run-review

agentutility / compose / agent-run-review
PRICE / CALL
$0.06
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
compose
CATEGORY
uncategorized
STATUS
live
NAME
agent-run-review agent run review / trace cost evals / post-run analysis / agent debugging in one call: hand it a raw agent execution trace and get a read…
SYNOPSIS
POST https://x402.agentutility.ai/agent-run-review
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

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

Agent run review / trace cost evals / post-run analysis / agent debugging in one call: hand it a raw agent execution trace and get a readable brief of what happened, a cost estimate for the run, and a first draft of regression eval cases to catch the same failure next time. Composite: one call runs agent-trace-brief + llm-cost-estimate + eval-case-generate in parallel and merges them into {review, cost_estimate, generated_evals}. agent-trace-brief turns the raw steps/tool-calls into an ordered summary plus a root-cause hypothesis for any failure; llm-cost-estimate prices the run's tokens across a model list; eval-case-generate drafts candidate {input, expected, rubric} cases from the inferred task so the workflow gets regression coverage. Use it as an agent debugging API, a post-run trace reviewer, or a step toward turning production incidents into eval sets.

INPUTrequest schema
propertytypedescriptionreq?
tracearray | stringThe agent execution trace to review: a JSON array of steps/tool calls, or a plain-text log. Required. Serialized form capped at 40,000 chars.required
modelsarrayOptional list of model names to price the run's estimated tokens against, e.g. ['gpt-4o-mini','claude-sonnet-4.5']. Defaults to a standard model spread.optional
OUTPUTresponse shape
fieldtypedescription
trace_charsstring
reviewstring
cost_estimatestring
generated_evalsstring
composed_ofstring
componentsstring
degradedstring
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/agent-run-review \
  -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-run-review tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
composeagentrunreviewagent-run-review
methods
POST
cluster
compose
price
$0.06 USDC per call
ADJACENTother endpoints in compose
endpointdescriptionprice
brand-availability-sweepBrand availability sweep API for a name availability check before you commit to a startup, product, or project name: trademark signal, do…$0.06
browser-workflow-repairBrowser workflow repair / self-healing automation / dom drift fix / flow memory in one call for agents whose CSS selectors broke after a…$0.06
competitor-snapshotSnapshots a company for competitive intelligence in one call: profile, recent news, and news sentiment.$0.06
contact-golden-recordTurn 2-5 messy candidate contact records into one deduplicated golden record with per-field provenance.$0.06
content-authenticity-reportContent authenticity report: send a URL (or raw text) and find out whether a page is AI-generated slop before your agent cites, summarize…$0.06
cross-lingual-topic-monitorMonitor a topic across non-English sources in one call: search the open web and X, detect what language each hit is actually in, translat…$0.06
dependency-provenanceDependency risk and supply chain trust for one package in a single call: registry adoption stats, a package risk score, source repo healt…$0.06
grounded-answer-checkAnswer a question and grade how well the answer actually holds up against independent sources, in one call.$0.06
SEE ALSO
agentutility · compose · x402 · mcp · llms.txt · registry.json · bazaar.x402.org