Skip to main content

​
Overview

Retrieve the complete definition of a tool including its input/output schemas, destructive flag, and metadata. Use this after search_tools to understand a tool’s interface before calling it via call_tool (HTTP transport) or in a run script (stdio transport).
Like search_tools, the HTTP transport’s read_tool only resolves paths from the per-user available catalog. A path that exists in the codebase but whose authProvider isn’t connected returns Tool not found: <path>.

​
Input

ParameterTypeRequiredDescription
pathstringYesTool path (e.g., github.issues.create)

​
Annotations

  • readOnlyHint: true

​
Output

Returns the full ToolDefinition object: 
{
  "path": "github.issues.create",
  "name": "Create Issue",
  "description": "Create a new issue in a GitHub repository.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "owner": { "type": "string" },
      "repo": { "type": "string" },
      "title": { "type": "string" },
      "body": { "type": "string" },
      "labels": { "type": "array", "items": { "type": "string" } },
      "assignees": { "type": "array", "items": { "type": "string" } }
    },
    "required": ["owner", "repo", "title"]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "number": { "type": "number" },
      "url": { "type": "string" }
    },
    "required": ["number", "url"]
  },
  "destructive": true,
  "authProvider": "github"
}
If the tool is not found, returns an error message: 
"Tool not found: some.invalid.path"

​
Also available in sandbox

Inside run scripts: 
const schema = await tools.describe.tool({ path: "github.issues.create" });