Agent Manifest


GET /.well-known/agent-manifest.json

Returns a JSON manifest describing the gateway, its capabilities, available endpoints, and payment methods. This is the primary discovery mechanism for autonomous agents.

Response


{
  "did": "did:web:402claw.cloud",
  "name": "402claw.cloud X402 AI Gateway",
  "version": "1.0",
  "specVersion": "a2a-2026-02",
  "authentication": [
    {
      "type": "X402",
      "description": "EIP-712 signed USDC payment on Base network",
      "paymentHeader": "X-PAYMENT",
      "network": "base",
      "asset": "USDC",
      "docs": "https://x402.org"
    },
    {
      "type": "DirectUSDC",
      "description": "Submit on-chain USDC transfer hash for verification",
      "endpoint": "https://402claw.cloud/api/proxy-generate",
      "requiredFields": ["slug", "prompt", "txHash"],
      "network": "base",
      "asset": "USDC"
    }
  ],
  "endpoints": {
    "generate": "https://402claw.cloud/api/x402/{slug}",
    "generateDirect": "https://402claw.cloud/api/proxy-generate",
    "taskStatus": "https://402claw.cloud/api/task/{taskId}",
    "llmstxt": "https://402claw.cloud/llms.txt",
    "endpointList": "https://402claw.cloud/sitemap.xml"
  },
  "agentCapabilities": ["text-to-image", "document-parsing"],
  "availableEndpoints": [
    {
      "slug": "nano-banana",
      "title": "Nano Banana Pro",
      "description": "Fast AI image generation",
      "price": 0.05,
      "priceCurrency": "USDC",
      "model": "nano-banana-pro",
      "provider": "kie",
      "capability": "text-to-image",
      "url": "https://402claw.cloud/api/x402/nano-banana",
      "requiredFields": ["prompt"]
    }
  ],
  "identity": {
    "walletAddress": "0x...",
    "network": "base"
  },
  "created": "2026-02-25",
  "updated": "2026-02-27"
}

Key Fields

`authentication[]`

Lists supported payment methods:

X402 — Automatic payment via EIP-712 signature (used by x402-fetch)
DirectUSDC — Manual USDC transfer with transaction hash verification

`endpoints`

URL templates for all API operations:

generate — X402 payment-gated generation ({slug} is a placeholder)
generateDirect — Direct USDC generation
taskStatus — Task polling ({taskId} is a placeholder)

`availableEndpoints[]`

Array of all active AI models. Each entry includes:

Field	Description
`slug`	URL identifier to use in API calls
`title`	Human-readable model name
`price`	Cost per request in USDC
`capability`	What it does: `text-to-image`, `document-parsing`, etc.
`requiredFields`	Fields the endpoint needs (usually just `["prompt"]`)
`url`	Full URL for the X402 endpoint

`identity`

The gateway’s on-chain identity:

walletAddress — Where to send USDC for direct payments
network — Always base

Usage


# Fetch and pretty-print the manifest
curl -s https://402claw.cloud/.well-known/agent-manifest.json | jq
 
# Get just the available endpoints
curl -s https://402claw.cloud/.well-known/agent-manifest.json | jq '.availableEndpoints'
 
# Get the gateway wallet address
curl -s https://402claw.cloud/.well-known/agent-manifest.json | jq '.identity.walletAddress'