Find a published agent package
onchain_agent_search_listingsUSE WHEN someone wants a ready-made onchain agent package to download or fork rather than assemble one. Searches Sato Hub's published agent packages — each a public view of one sealed, immutable version: its task, inputs/outputs, required permissions, model support ("configured, not evaluated"), license, and evidence freshness for that exact digest.
Returns (json): { listings: [{ slug, title, task, version: { digest }, recipe, license, fork_permitted, evidence_freshness, integrity, acquisition_modes, sato_url, superseded_by, ... }], next_cursor }. superseded_by is the id of the nightly-checked template that replaces a package (generate it with onchain_agent_create_agent), or null; the package itself still downloads.
RULE ENFORCED: evidence counts only rows recorded against the package's exact digest — "not_checked" means none exist. A result is scoped to its test; it is not a safety, security or returns claim. No signed download URL is ever returned; cite sato_url. Read-only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | Free text over a published package's title, task and description. | |
| cursor | No | The next_cursor from a previous page. | |
| recipe | No | Only packages built from this recipe id, e.g. 'treasury-balance-monitor'. | |
| license | No | Only packages under this SPDX license id, e.g. 'MIT'. | |
| response_format | No | Text format; structuredContent is JSON either way. | markdown |