check_agent_policy

What is check_agent_policy?

check_agent_policy is a paid work product in the Web Intel category on agenttoll.dev. It costs $0.01 per call, settled in USDC on Base via the x402 payment protocol. No API keys or accounts: your agent inspects the metadata, explains the expected result, caps the spend, calls the tool, and receives structured JSON with a receipt envelope.

Input parameters

Only send these request-body fields. If this block is empty, send {}.

{
  "domain": "string, example example.com"
}

Request body

{
  "domain": "example.com"
}

MCP call

Connect an MCP client to the endpoint, call tool check_agent_policy, and pass the request body as arguments.

https://agenttoll.dev/mcp

MCP paid-tool calls may surface the payment challenge inside the JSON-RPC result instead of as a raw HTTP 402.

What the agent needs to transact

{
  "mcp": {
    "endpoint": "https://agenttoll.dev/mcp",
    "tool": "check_agent_policy",
    "arguments": {
      "domain": "example.com"
    }
  },
  "payment": {
    "protocol": "x402",
    "scheme": "exact",
    "price_usd": "0.01",
    "max_payment_usd": "0.01",
    "network": "eip155:8453",
    "network_name": "Base mainnet",
    "asset": "USDC",
    "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "pay_to": "0x62a0D3d9DF0dE8804983009949c714EaeAFd87F1"
  },
  "expected_result": "JSON with source-backed fields, response metadata, and decision/readout fields where the endpoint is a brief.",
  "approval_prompt": "This AgentToll call costs $0.01 on Base mainnet. Verify payTo 0x62a0D3d9DF0dE8804983009949c714EaeAFd87F1, asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, and maxPayment $0.01 before approving. It returns JSON with source-backed fields, response metadata, and decision/readout fields where the endpoint is a brief.",
  "receipt": "https://agenttoll.dev/receipt/:tx",
  "receipt_schema": "https://agenttoll.dev/agenttoll-receipt-v1.md"
}

Agent approval metadata

Use this before asking a user to approve payment. It states the cap, seller wallet, asset, route, and expected result in one buyer contract.

Suggested approval line: This AgentToll call costs $0.01 on Base mainnet. Verify payTo 0x62a0D3d9DF0dE8804983009949c714EaeAFd87F1, asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, and maxPayment $0.01 before approving. It returns JSON with source-backed fields, response metadata, and decision/readout fields where the endpoint is a brief.

{
  "schemaVersion": "agenttoll.buyer_contract.v1",
  "service": "agenttoll.dev",
  "tool": "check_agent_policy",
  "category": "Web Intel",
  "method": "MCP tools/call",
  "endpoint": "https://agenttoll.dev/mcp",
  "priceUsd": "0.01",
  "maxPaymentUsd": "0.01",
  "protocol": "x402",
  "scheme": "exact",
  "network": "eip155:8453",
  "networkName": "Base mainnet",
  "asset": "USDC",
  "assetContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "payTo": "0x62a0D3d9DF0dE8804983009949c714EaeAFd87F1",
  "facilitator": "https://api.cdp.coinbase.com/platform/v2/x402",
  "requestBody": {
    "domain": "example.com"
  },
  "input": {
    "domain": "string, example example.com"
  },
  "expectedResult": "JSON with source-backed fields, response metadata, and decision/readout fields where the endpoint is a brief.",
  "verifyBeforePaying": [
    "network must equal eip155:8453",
    "asset contract must equal 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo must equal 0x62a0D3d9DF0dE8804983009949c714EaeAFd87F1",
    "maxPayment must be no more than $0.01",
    "resource path must match this endpoint"
  ],
  "receiptSchema": "https://agenttoll.dev/agenttoll-receipt-v1.md"
}

Pricing & payment

Paid JSON responses include agenttoll_receipt with request, result, and payment-term hashes. The receipt lets a user audit what the agent bought after the call. If your buyer runtime exposes a settlement transaction hash, verify it at /receipt/<tx>.

FAQ