docs — how agentutility works

$ man agentutility-docs

Three routes in. Pick the one that matches your agent harness. Every route hits the same endpoints, settled in USDC on Base via the x402 protocol.

§ I x402 — the protocol in one paragraph

POST to any endpoint. If the request lacks payment, the server returns HTTP 402 Payment Required with a structured body describing exactly what to pay, where, and how. Sign a USDC transferWithAuthorization for that amount, attach the signed payment as an X-PAYMENT header, and retry. The facilitator settles on-chain and the response comes back in the same request lifecycle.

# 1. unpaid request
curl -X POST https://x402.agentutility.ai/secrets-exposure-check \
  -H 'Content-Type: application/json' \
  -d '{"repo":"vercel/next.js"}'

# response: 402 with payment requirements
{
  "x402Version": 1,
  "accepts": [{
    "scheme": "exact",
    "network": "base",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "maxAmountRequired": "20000",  /* 0.02 USDC, 6 decimals */
    "payTo": "0x8f5cb67b49555e614892b7233cfddebfb746e531"
  }]
}

# 2. sign + retry
curl -X POST https://x402.agentutility.ai/secrets-exposure-check \
  -H 'X-PAYMENT: $SIGNED_AUTHORIZATION' ...

§ II mcp — one install per cluster · live on npm

For coding agents (Claude Code, Cursor, Codex, Replit Agent), the portfolio is packaged as 8 cluster MCP servers under @agentutility/mcp-* (one per cluster: prooflayer, edge-market, edge-finance, synthforge, mediakit, wordmint, web-probe, locale). Each is a thin stdio shim over the HTTP endpoints above — the agent's own wallet signs every call, no custody on our side. Catalog + per-cluster install at mcp.agentutility.ai.

# 8 cluster packages on npm under
# @agentutility/mcp-*  (one per cluster)
#
# Catalog + install:
# https://mcp.agentutility.ai

§ III erc-8004 — on-chain agent discovery

agentutility's portfolio is registered on the ERC-8004 Identity Registry on Base as agentId 47167. Agents that resolve the URI get the full agent card with every endpoint enumerated and priced. Pure on-chain discovery — no DNS, no signup.

# resolve via our own agent-card endpoint
curl -X POST https://x402.agentutility.ai/agent-card-resolve \
  -H 'Content-Type: application/json' \
  -d '{"agent_id":47167}'

# → owner address, agent_uri, full card JSON

See the live card at /agent-card.

§ IV catalog — machine-readable registry

The full registry is served as JSON at /registry.json. Filter with ?cluster=<slug>. Plain-text alternatives: /endpoints.txt, /catalog.txt. LLM-tuned indexes: /llms.txt, /llms-full.txt.

# whole registry
curl https://agentutility.ai/registry.json

# one cluster
curl https://agentutility.ai/registry.json?cluster=edge-market

# llms.txt — Anthropic-blessed LLM index
curl https://agentutility.ai/llms.txt

# all endpoints, one per line
curl https://agentutility.ai/endpoints.txt