Search tools
search_toolsFind tools in the EasyCanDo catalog for one step of a build. Give a short query saying what the step does, and have and want when you know what goes in and what should come out. Returns up to 10 previews, best first: slug, one-line summary, the capability that matched with its input and output types, API status, price tier, the date it was checked and page URL, plus the arguments for the next page. Call get_tool before writing integration code.
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": "search_tools"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| free | No | Only tools that are free or have a free tier. | |
| have | No | What the step starts with. One of: words (words: text, query, message, social-post); photos (photos and images: image, image-mask, 3d); video (video: video); sound (voice and sound: audio-speech, audio, audio-music, audio-sfx); documents (documents: document); links (web links: url, webpage); places (places: geo); data (numbers and data: structured, timeseries, event-stream, embedding); code (code: code); money (money: money); people (people: profile); dates (dates and events: schedule). A type id in parentheses also works, and stands for the id before it. | |
| live | No | Only tools with live or real-time data. | |
| want | No | What the step should produce. One of: words (words: text, query, message, social-post); photos (photos and images: image, image-mask, 3d); video (video: video); sound (voice and sound: audio-speech, audio, audio-music, audio-sfx); documents (documents: document); links (web links: url, webpage); places (places: geo); data (numbers and data: structured, timeseries, event-stream, embedding); code (code: code); money (money: money); people (people: profile); dates (dates and events: schedule); done (something done: action:publish, action:message, action:money, action:world, action:software, action:browser, action:schedule, action:record, physical-item). A type id in parentheses also works, and stands for the id before it. “done” means the tool acts: it posts, sends, pays, books or changes something. | |
| group | No | Only one group. One of: images (make, edit and fix pictures); video (make and edit video, avatars and 3d); voice (speak, transcribe, compose and clean up sound); design (make documents, slides and designs); ai (language models and agents that think and act); reading (read text out of pages, photos, audio and video); web (search the web and follow the news); social (read what people post and say); knowledge (papers, books, records and public data); world (weather, sky, earth, flights and places); posting (publish posts and send messages); money (markets, payments, stores and ads); home (lights, devices, deliveries and real things); mac (tools that run on your own mac, so nothing leaves it); building (code, data, hosting and the parts apps are made of). | |
| limit | No | Results per page, 1 to 10. Default 5. | |
| local | No | Only tools that run on the user’s own machine. | |
| query | No | What the step does, in a few words: “transcribe audio”, “vector database”, “send sms”. | |
| offset | No | Results to skip. Use the next-page arguments a search returns. | |
| official | No | Only tools with an official API. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | Yes | The arguments for the next page, to send as they are. Null on the last page. | |
| note | Yes | ||
| total | Yes | Results in all, across every page, looser matches left out. With fallback true, the tools the filters leave. | |
| looser | Yes | Looser matches left out: they match only part of the query, or only a side feature. | |
| offset | Yes | ||
| results | Yes | ||
| widened | Yes | Results after the ones that pass have and want: matches for the query with other inputs or outputs. search_tools adds them only when fewer than 3 tools pass. The note says how many passed. | |
| fallback | Yes | True when nothing matched the query. With have or want, results are every tool those filters leave, best known first, ties by name; without, results are empty. The note says how to search instead. |