search_tools

Finds your API's operations by keyword, in search mode. With hundreds of operations, listing every tool fills an agent's context before it starts. In search mode the agent finds the few it needs here, reads them with describe_tool, and runs one with call_tool.

When it's listed

In search mode: when the tool mode is search, or auto and the server has more operation tools than the search threshold (40 unless you change it). They replace the operation tools in the list. See search and code mode.

Arguments

querystring

What the operation does, in a few words, such as create invoice. Matches names, descriptions, paths and groups.

groupstring

Only operations in this group, from list_tool_groups. Offered only when the operations fall into two or more groups.

limitintegerdefault: 10

How many results to return, from 1 to 25.

offsetintegerdefault: 0

Skip this many results, to page through a long match.

Returns

How many operations match, then a line each, best first: name, method and path, summary, required arguments, and whether a call asks the user first.

Hints

The annotations a client reads to decide what may run without asking the user.

Hint	Value	When true, it means
`readOnlyHint`	`true`	It doesn't change anything
`openWorldHint`	`false`	It reaches outside the server, over the network

Examples

Find an operation

{
  "name": "search_tools",
  "arguments": {
    "query": "cancel a subscription",
    "limit": 4
  }
}

8 operations of 23 match "cancel a subscription" (showing 1 to 4):

cancelSubscription · POST /subscriptions/{subscriptionId}/cancel · Cancel a subscription · requires: subscriptionId · asks the user first
listSubscriptions · GET /subscriptions · List subscriptions · no required arguments
createSubscription · POST /subscriptions · Start a subscription · requires: body · asks the user first
updateSubscription · PATCH /subscriptions/{subscriptionId} · Change a subscription · requires: subscriptionId, body · asks the user first

Next: describe_tool with the names you need, then call_tool. Pass offset 4 for more.

Search mode tools: describe_tool, call_tool, list_tool_groups.
Search and code mode: when the server switches, and how to choose.
Permissions and limits: the rules every call keeps.