describe_tool

Returns the full description and input schema of up to five operations. What the agent reads between finding an operation and calling it: every argument, which are required, and whether a call asks the user first.

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

namesarray of stringsrequired

One to five operation names, exactly as search_tools printed them.

Returns

A section per operation: method and path, group, whether it asks first or can change data, its description, and its input schema as JSON.

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

Describe one operation

{
  "name": "describe_tool",
  "arguments": {
    "names": [
      "cancelSubscription"
    ]
  }
}

## cancelSubscription
POST /subscriptions/{subscriptionId}/cancel · group: Subscriptions · asks the user to approve each call · can change or delete data

Cancel a subscription

Each call asks the user to approve it first. If they decline, do not retry unless they ask you to.

Input schema: {"type":"object","properties":{"subscriptionId":{"type":"string"},"body":{"type":"object","properties":{"atPeriodEnd":{"type":"boolean","description":"Keep the subscription running until the period it has already been billed for is over."},"reason":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false,"required":["subscriptionId"]}

Run one with call_tool.

Search mode tools: search_tools, 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.