toolstool search

Tool Search

tool_search

Finds the best available MCP tools for a task with ranked natural-language matching, safety/capability filters, connector filters, and optional input summaries. Understands related terms such as semantic → vector/relevance and database → SQLite/schema/query. Use when: choosing the right tool before acting, finding local-only or read-only tools, or checking required inputs. Scope: reads the local tool registry only; no network access. Not for: executing a tool, configuring credentials, or managing MCP client configuration.

How to use tool_search

Provide only the required inputs below. Start with the smallest scope that answers the task, then review the risk properties before an agent executes the call.

Risk and execution properties

Read only: yes

Destructive: no

Idempotent: yes

Open world: no — operates locally or through configured services

Inputs

querystring

Natural-language task or keywords. Matches names, descriptions, capabilities, and related terms. Optional.

tagsstring

Comma-separated filters: api_required, local_only, network_access, write_tool, read_only, requires_confirmation.

modulestring

Top-level module: code, data, memory, or tools.

submodulestring

Optional submodule filter, such as codebase_analysis or security.

connectorstring

Only return tools requiring this connector, for example github.

max_resultsinteger

Maximum ranked tools returned. Max: 100.

Default: 20

include_inputsboolean

Include required input names and all supported input names per result.

Default: false

Example input

{
  "query": "<string>",
  "tags": "<string>",
  "module": "<string>",
  "submodule": "<string>",
  "connector": "<string>",
  "max_results": 20,
  "include_inputs": false
}

Browse or search the full 74-tool reference to choose the smallest suitable capability.

Browse all tools →