search
Read-onlyIdempotent
Read-only catalog lookup without saving a conversation. Return up to three relevant agents ranked by latest successful verification, recent activity, and quality grade. Searches A2A first, then MCP; x402 requires an explicit choice. Use when you need up to three ranked candidates for one task without keeping conversation state. Example arguments: {"task": "translate a document to Spanish"}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| k | No | Compatibility field; at most three results is returned. | |
| auth | No | Compatibility field; authentication preference does not affect ranking. | |
| kind | No | Explicit recommendation protocol filter; Any searches A2A then MCP, excluding x402. Defaults to A2A first, then MCP; x402 requires an explicit choice. | |
| task | Yes | The specific capability needed (e.g. 'weather forecast', 'stock price', 'web search') | |
| category | No | Compatibility field; task relevance is derived from the task text. | |
| visitor_token | No | Your visitor token (vt_…) so I remember you. Omit on first contact. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| text | Yes | ||
| intent | No | ||
| status | No | ||
| visitor | No | ||
| execution | No | ||
| recommendations | No |