Search agents
search_agentsRead-onlyIdempotent
Find agents and MCP servers that can do a task you describe in plain words. Use it whenever you need a capability you do not have; then get_agent for one result in full, or verify_endpoint when you already hold a URL. Ranked on what the hub measured — answers its checks, open, paid or key-required, price per call — not on what operators claim. Read-only, no account. Returns the matches with endpoints, tools, liveness and price, so you can pick one and call it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | What needs doing, in natural language or keywords | |
| kind | No | Limit to one protocol | |
| limit | No | Max results (default 7, best first). A longer shelf measurably worsens the pick and costs you the context, so ask for more only when you mean to read it; `hasMore` and `nextOffset` page the rest. | |
| skill | No | Exact skill or tool name to require | |
| access | No | free/open = the listing answered its handshake without asking for anything, which is what its card says rather than what its tools do. verified-open = this hub has called one of its tools and been served. Ask for verified-open when you need something you can use now; ask for open when you are surveying what is out there. | |
| offset | No | Where to resume — pass the `nextOffset` from the last answer | |
| warning | No | none = leave out listings whose text works on the agent reading it (posing as system instructions, demanding to be called first, pushing referral links…); any = only those; a kind = only that behaviour. Rows that have one carry it as `warning`. | |
| category | No | A topic, as `area` or `area/topic` (e.g. weather-and-environment/forecast); the listings carry theirs as `topic`. `suspicious` (or `suspicious/<kind>`, e.g. suspicious/poses-as-system) is the category of listings whose text works on the agent reading it | |
| transport | No | Only listings served over this transport, e.g. streamable-http, sse or http |