Skip to main content

​
Overview

Search the tool catalog to discover available tools. Returns matching tools with their path, name, description, and destructive flag.

​
Input

ParameterTypeRequiredDefaultDescription
querystringYes—Search query matched against tool path, name, and description
limitintegerNo10Maximum number of results to return

​
Annotations

  • readOnlyHint: true

​
Output

Returns an array of matching tools: 
[
  {
    "path": "github.issues.list",
    "name": "List Issues",
    "description": "List issues in a GitHub repository, optionally filtered by state and labels.",
    "destructive": false
  },
  {
    "path": "github.issues.create",
    "name": "Create Issue",
    "description": "Create a new issue in a GitHub repository.",
    "destructive": true
  }
]

​
Search algorithm

The search uses weighted fuzzy matching across multiple fields:
FieldWeight
Tool path12
Tool name10
Description5
Exact segment match+8 bonus
Multiple search tokens use AND semantics — all tokens must match for a result to be included.

​
Also available in sandbox

Inside run scripts, the same search is available as: 
const results = await tools.search({ query: "email", limit: 5 });