{
  "type": "https://eips.ethereum.org/EIPS/eip-8257#tool-manifest-v1",
  "name": "agent-binding-scout",
  "description": "Discovery primitive for ERC-8217 agent-bound NFTs in any OpenSea collection. Given a collection slug, returns the subset of NFTs with an agent binding, each enriched with the inline binding payload (agent_id, binding_contract, agent { chain, token_id, contract_address }, registered_by). Built on OpenSea's `has_agent_binding=true` filter (May 2026). Per-NFT enrichment is serialized to dodge OpenSea's stale-cache bug on parallel fan-out. 60s in-memory cache per (collection, chain, limit).",
  "endpoint": "https://www.clawbots.org/api/tools/agent-binding-scout",
  "inputs": {
    "type": "object",
    "properties": {
      "collection": {
        "type": "string",
        "description": "OpenSea collection slug (e.g. 'normies'). Required."
      },
      "chain": {
        "type": "string",
        "default": "ethereum",
        "description": "Chain identifier used for the per-NFT enrichment fetch. Defaults to 'ethereum'."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 10,
        "default": 5,
        "description": "Number of bound NFTs to return. Capped at 10 \u2014 each entry costs one additional OpenSea call."
      }
    },
    "required": [
      "collection"
    ],
    "additionalProperties": false
  },
  "outputs": {
    "type": "object",
    "properties": {
      "collection": {
        "type": "string"
      },
      "chain": {
        "type": "string"
      },
      "fetchedAt": {
        "type": "string",
        "format": "date-time"
      },
      "bindingsFound": {
        "type": "integer"
      },
      "next": {
        "type": [
          "string",
          "null"
        ],
        "description": "Opaque cursor from OpenSea for the next page, or null when exhausted."
      },
      "bindings": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "nft": {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string"
                },
                "contract": {
                  "type": "string"
                },
                "name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "image_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "opensea_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            },
            "binding": {
              "type": [
                "object",
                "null"
              ],
              "description": "ERC-8217 agent_binding payload from OpenSea's get_nft endpoint",
              "properties": {
                "agent_id": {
                  "type": "string",
                  "description": "ERC-8004 agent token id"
                },
                "binding_contract": {
                  "type": "string",
                  "description": "ERC-8217 binding contract address"
                },
                "agent": {
                  "type": "object",
                  "properties": {
                    "chain": {
                      "type": "string"
                    },
                    "token_id": {
                      "type": "string"
                    },
                    "contract_address": {
                      "type": "string",
                      "description": "ERC-8004 adapter contract for the agent"
                    }
                  }
                },
                "registered_by": {
                  "type": "string",
                  "description": "Wallet that registered the binding"
                }
              }
            }
          }
        }
      }
    },
    "required": [
      "collection",
      "chain",
      "fetchedAt",
      "bindingsFound",
      "bindings"
    ]
  },
  "creatorAddress": "0x523eff3db03938eaa31a5a6fbd41e3b9d23edde5",
  "pricing": [
    {
      "amount": "10000",
      "asset": "eip155:8453/erc20:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "recipient": "eip155:8453:0x523eff3db03938eaa31a5a6fbd41e3b9d23edde5",
      "protocol": "x402"
    }
  ],
  "tags": [
    "nft",
    "agent-binding",
    "erc-8217",
    "erc-8004",
    "opensea",
    "discovery",
    "x402"
  ]
}
