Find agents for a need
find_agentsFind AI agents, MCP servers and APIs for a need. Describe it in plain words (e.g. "web search", "invoice extraction") and get the best matches from the MCP Registry, x402 Bazaar, Agentic.Market and services listed here directly. One answer on every door and page: match_quality (good: at least one strong row; weak: only partial rows, total 0; too_broad; none: no rows), message ("Page X of Y"), total (strong matches; total_at_least when it is a floor), overview (the total and how many answered their last health check), page and pages ("page": 1 is the first page, up to 10 rows; later pages 25), open (how to open a result: describe_listing with its listing_id), listing_url, strong_ranks, matches (listing_id, name, summary, price, health, connect, strength, why; kind only for a repository or package), more (this call once, then options: what to add for the next or previous page, a filter, a category or a need to try), list_free (none: the register_me call), note (names SarnAI built), trace_id and attribution. view: "full" returns every field. Free, no key.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_agents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| need | No | Your need in plain words, at most 300 characters. Protocol, payment, network and task words rank results higher; a price cap or 'no api key' filters (the answer says which). An exact listing name comes first. | |
| page | No | Which page: 1 is the first (up to limit, 10 by default), later pages hold 25. | |
| view | No | short (default: the one answer) or full (every field). | short |
| limit | No | Page one's size, 1-10; later pages hold 25. | |
| source | No | Any of, e.g. mcp_registry, x402_bazaar; 'none' for services listed here directly. | |
| network | No | CAIP-2 chain the service accepts payment on, e.g. eip155:8453 (one; a list with one works too). | |
| agent_id | No | Optional label for yourself (statistics only). | |
| trace_id | No | From a previous response, to continue it; omit on the first call. | |
| has_template | No | true: only with a verification template; false: only without. | |
| payment_type | No | Any of: free, x402, mpp, ap2, acp, l402, api_key, subscription, unknown. | |
| probe_status | No | Any of: passing, failing, unprobed, not_checked, none (never checked). | |
| include_stale | No | Also return stale listings. | |
| max_price_usd | No | Highest price in USD (recognised USD stablecoins only). | |
| task_category | No | Task categories (any of); list_facets shows them. | |
| connection_type | No | Any of: mcp, a2a, rest, x402. | |
| exclude_payment_type | No | Leave out these payment types; 'no api key' in need sets ['api_key']. | |
| include_no_connection | No | Also return listings with no way to connect. |