Find live registered agents
onchain_agent_search_agentsUSE WHEN you need a RUNNING agent to work with, hire or pay — not a tool to build one with — and want to see who registered it, on which chain, and whether it accepts payment. Searches the Sato Agent Registry: agents whose creators registered them for a Sato Agent Passport (distinct from the resource directory, which lists the things agents are built FROM). Filter by free-text query, chain, agent_type, or x402_only. Only human-review-listed agents are returned.
This is the Sato Agent Registry only: agents whose builders registered them with Sato Hub, a small set. It does not search agents registered onchain under ERC-8004, so an empty answer here says nothing about them. For those, call onchain_agent_get_agent_economy with venue "erc8004" (measured counts by chain), or see https://satohub.ai/agent-economy/erc8004 and https://satohub.ai/erc8004/.
Trust rule: registration is self-reported by the creator; verification_status distinguishes Self-Reported from evidence-reviewed Verified/Audited. Nothing here implies safety or performance.
Returns (json): { total, agents: [{ sato_agent_id, slug, name, description, agent_type, chains_supported, stack, payment/x402 metadata, verification_status, profile_url, manifest_url }] }. Read-only.
Example: { chain: "Base", x402_only: true }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Filter to agents supporting this chain. | |
| query | No | Free-text search across agent name, description, creator, stack, and type. | |
| x402_only | No | True = only agents exposing an x402 payment endpoint. | |
| agent_type | No | Filter by agent utility type: trading, research, defi, payments, security, social, workflow, gaming, data, coding. | |
| response_format | No | Text format; structuredContent is JSON either way. | markdown |