AGENTRESOLVER DOCS

Verify an x402 payment before your agent signs it.

The primary paid route is /api/x402-payment-preflight: a $0.001 USDC live check of payTo, quote price, network, asset, resource binding, challenge structure, TLS and reachability on Base or Solana. Free capability resolution remains available over MCP and REST.

$0.001 x402 payment preflight

Use this immediately before paying an unfamiliar or changed x402 endpoint. Optional maxPriceUsd, expectedPayTo, and expectedNetwork fields turn the response into a caller policy gate. An unpaid request returns the complete 402 quote without spending.

curl -i https://agentresolver.vercel.app/api/x402-payment-preflight

# With an x402-aware client, POST after authorizing the quoted $0.001:
POST /api/x402-payment-preflight
Content-Type: application/json

{
  "url": "https://merchant.example/api",
  "method": "GET",
  "maxPriceUsd": 0.01
}

AgentCash direct onboarding

AgentCash can discover the origin, inspect its x402 routes, make a buyer-authorized paid call, and save the origin for reuse.

npx agentcash try https://agentresolver.vercel.app
npx agentcash add https://agentresolver.vercel.app

Install as a persistent MCP fallback

Remote MCP endpoint: https://agentresolver.vercel.app/mcp. The server exposes free resolution plus read-only quote/discovery tools for paid capabilities; no quote tool authorizes spending.

Install in VS Code

For portable MCP hosts, workspace .mcp.json, or user MCP configuration, add this server definition:

{
  "servers": {
    "agentresolver": {
      "type": "http",
      "url": "https://agentresolver.vercel.app/mcp"
    }
  }
}

Free REST resolver

Send a natural-language goal to POST /api/resolve. Resolution is free and read-only. It never authorizes or initiates a payment.

curl -X POST https://agentresolver.vercel.app/api/resolve \
  -H "content-type: application/json" \
  -d '{"goal":"find a GitHub MCP server"}'

$0.005 Agent Readiness Audit

POST /api/agent-readiness audits a public website for llms.txt, ARD, OpenAPI, sitemap, MCP metadata, robots and baseline headers. It costs $0.005 USDC on Base or Solana.

curl -X POST https://agentresolver.vercel.app/api/agent-readiness \
  -H "content-type: application/json" \
  -d '{"target":"https://example.com"}'

Payment behavior

Paid routes expose their exact price, asset, network and recipient in HTTP 402 before execution. The calling agent applies its own authorization and budget policy, then retries with a valid x402 payment. AgentResolver does not sign on behalf of buyers.

Discovery

agent guide · integration recipes · llms.txt · OpenAPI · x402 manifest · MCP metadata · capability catalog