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

/tool-call-diff

agentutility / agentops / tool-call-diff
PRICE / CALL
$0.008
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
agentops
CATEGORY
uncategorized
STATUS
live
NAME
tool-call-diff deterministic tool call diff between two agent run sequences
SYNOPSIS
POST https://x402.agentutility.ai/tool-call-diff
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

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

Deterministic tool call diff between two agent run sequences. Send before and after arrays of tool calls (name/args or tool/arguments shape) and get back which calls were added, removed, or reordered, plus per-call argument drift with the exact changed argument paths from a deep compare. No LLM involved, so results are exact and reproducible: the same replay comparison always returns the same diff. Built for agent regression diff work: confirming a prompt or code change didn't silently alter which tools an agent calls or what it passes them. Use it as a tool call diff API, an agent action drift checker, or a replay comparison step in CI before shipping an agent change.

INPUTrequest schema
propertytypedescriptionreq?
beforearrayThe baseline tool-call sequence: a JSON array of call objects, each shaped {name, args} (or {tool, arguments} / {tool_name, input}). Required, max 500 entries.required
afterarrayThe new tool-call sequence to compare against 'before', same shape. Required, max 500 entries.required
OUTPUTresponse shape
fieldtypedescription
before_countstring
after_countstring
addedstring
removedstring
reorderedstring
arg_driftedstring
unchanged_countstring
identicalstring
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/tool-call-diff \
  -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 tool-call-diff tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
agentopstoolcalldifftool-call-diff
methods
POST
cluster
agentops
price
$0.008 USDC per call
ADJACENTother endpoints in agentops
endpointdescriptionprice
agent-trace-briefTurns 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…$0.02
eval-case-generateEval 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-scoreHeuristic MCP tool risk review for an MCP tool manifest before you wire it into an agent.$0.02
SEE ALSO
agentutility · agentops · x402 · mcp · llms.txt · registry.json · bazaar.x402.org