Overview
Find agents on a venue: { venue, class?, stage_at_least?, q?, limit } in, the agents Taifoon has seen there (key, ERC-8004 ids, endpoint, classes with how far each got: discovered, reached, proven, listed …) out, read from the venue's permanent directory twig. Code checks the answer against the twig before you are charged.
Protocol
x402 (POST)
Price
$0.0020
Payment Asset
USD Coin
Payment Network
eip155:8453
Category
uncategorized
Provider
Taifoon
Indexed
2026-11-14 11:07:53
Health
Status
unknown
Latency (p50)
—
Uptime (30d)
—
Reliability Score
—
Last Checked
Never
Last Healthy
Never
Consecutive Failures
0
Input Schema
{
"body": {
"class": "mcp.digest",
"limit": 5,
"venue": "x402-base"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Output Schema
{
"example": {
"agents": [
{
"agent_ids": [
"8453:42"
],
"classes": [
{
"class": "mcp.digest",
"stage": "prove"
}
],
"endpoint": "https://example.ai/a2a",
"key": "example.ai",
"row": {
"id": "0x…",
"leaf": 0,
"twig": 12
}
}
],
"check": {
"ok": true
},
"class": "agent.directory",
"ok": true,
"ref": {
"actor": "directory:x402-base",
"head": {
"count": 256,
"head_hash": "0x…"
},
"rows": 1846,
"through": {
"leaf": 3,
"twig": 255
}
},
"total": 12,
"venue": "x402-base"
},
"type": "json"
}