Get Tool Usage

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READghl.get_tool_usage

• Contract tier: agent_ready
• Risk: read
• Catalog version: 2026-07-12.2
• Descriptor hash: 4703b491f0ebd4807aa9c256e176d69c9bdced17bc7bbf5b8bce7b33cd62522e

Use this after discovery to retrieve one GHL tool's complete lossless descriptor, including aliases, schemas, risk annotations, deprecation state, documentation, and destructive confirmation rule. It does not execute the selected tool.

Request Body

{
  "jsonrpc": "2.0",
  "id": "ghl-get-tool-usage-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.get_tool_usage",
    "arguments": {
      "tool_name": "tool_name_example"
    }
  }
}

Arguments Schema

{
  "type": "object",
  "required": [
    "tool_name"
  ],
  "properties": {
    "tool_name": {
      "type": "string",
      "description": "Native tool name, canonical service-qualified name, or exact compatibility alias from this manifest."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the GHL MCP operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Tool-specific GHL or local navigation result when ok is true."
    },
    "meta": {
      "type": "object",
      "description": "Safe execution, routing, and timing metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "description": "Safe error details when ok is false; credential values are never returned."
    }
  },
  "description": "Normalized GHL MCP response envelope.",
  "additionalProperties": false
}

Code Examples

cURL

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "ghl-get-tool-usage-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.get_tool_usage",
    "arguments": {
      "tool_name": "tool_name_example"
    }
  }
}'

Node.js

const response = await fetch('https://portal.madpanda3d.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mad_live_***',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "id": "ghl-get-tool-usage-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.get_tool_usage",
    "arguments": {
      "tool_name": "tool_name_example"
    }
  }
}),
});
const data = await response.json();
console.log(data);

Python

import requests

url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
    'Authorization': 'Bearer mad_live_***',
    'Content-Type': 'application/json',
}
payload = {
  "jsonrpc": "2.0",
  "id": "ghl-get-tool-usage-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.get_tool_usage",
    "arguments": {
      "tool_name": "tool_name_example"
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool ghl.get_tool_usage executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}

502 Upstream Error

{
  "ok": false,
  "classification": "upstream_http_error",
  "message": "Upstream MCP returned a non-success status."
}