get_tool

Use get_tool after search_tools or when a prompt names a tool and you need the exact schema, annotations, usage guidance, and related tools

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
name	Annotated[str, Field(description="Name of the MCP tool to look up (e.g. 'run', 'create_file', 'query_data').")]	Yes	—
detail	Annotated[ToolDetail, Field(description='Detail level to return: schema, usage, or full.')]	No	'schema'

Returns

Returns a structured object. Top-level fields:

• name (string)
• title (string)
• domain (string)
• tier (string)
• description (string)
• input_schema (object)
• output_schema (null)
• annotations (object)
• related_tools (array<string>)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "get_tool",
  "arguments": {
    "name": "create_dashboard"
  }
}

Response

{
  "name": "create_dashboard",
  "title": "Create Dashboard",
  "domain": "dashboard",
  "tier": "cold",
  "description": "Create or update a saved dashboard for a Bridge Town project.",
  "input_schema": {
    "type": "object",
    "required": [
      "project_name",
      "dashboard_name",
      "chart_type",
      "model_run_id",
      "output_key"
    ],
    "properties": {
      "project_name": {
        "type": "string"
      },
      "dashboard_name": {
        "type": "string"
      },
      "chart_type": {
        "type": "string"
      },
      "model_run_id": {
        "type": "string"
      },
      "output_key": {
        "type": "string"
      },
      "description": {
        "type": "string"
      },
      "subtitle": {
        "type": "string"
      },
      "currency": {
        "type": "string"
      }
    }
  },
  "output_schema": null,
  "annotations": {
    "title": "Create Dashboard",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": false
  },
  "related_tools": [
    "list_chart_types",
    "share_dashboard"
  ]
}

Notes

• Module: Tool Discovery
• Requires authentication via API token or Auth0 JWT.