Qdrant Get Tool Usage

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READqdrant.get_tool_usage

• Contract tier: agent_ready
• Risk: read
• Catalog version: qdrant-2026.07.12.2
• Descriptor hash: 270fee3de6ae9759b08875be7dd0404079a28917d6fb70d607810992190a938a

Use this when you need to retrieve one complete tool descriptor by native name, canonical name, or compatibility alias. It does not intentionally change Qdrant or MCP state. It reads the provider-owned catalog in memory and does not contact Qdrant. Returns normalized provider data in data plus safe request and trace metadata in meta. Requires an authenticated MAD MCP Portal request and any provider configuration named by the input schema.

Request Body

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

Arguments Schema

{
  "type": "object",
  "title": "Qdrant Get Tool Usage input",
  "properties": {
    "tool": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Tool",
      "default": null,
      "description": "Compatibility alias for tool_name; use tool_name when possible."
    },
    "tool_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Tool Name",
      "default": null,
      "description": "Canonical tool name to inspect."
    }
  },
  "description": "Validated input contract for the get_tool_usage native Qdrant MCP tool."
}

Output Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "descriptor"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "Compatibility native tool name."
        },
        "guidance": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional workflow-specific next-step guidance."
        },
        "descriptor": {
          "type": "object",
          "description": "Complete catalog descriptor.",
          "additionalProperties": true
        },
        "annotations": {
          "type": "object",
          "description": "Compatibility MCP safety annotations.",
          "additionalProperties": true
        },
        "description": {
          "type": "string",
          "description": "Compatibility full tool description."
        },
        "input_schema": {
          "type": "object",
          "description": "Compatibility complete input schema.",
          "additionalProperties": true
        }
      },
      "description": "One lossless Qdrant descriptor and safe usage guidance.",
      "additionalProperties": false
    },
    "meta": {
      "type": "object",
      "properties": {
        "bytes_in": {
          "type": "integer",
          "description": "Approximate serialized input byte count."
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Safe recovery warnings."
        },
        "bytes_out": {
          "type": "integer",
          "description": "Approximate serialized output byte count."
        },
        "elapsed_ms": {
          "type": "integer",
          "description": "Tool execution time in milliseconds."
        },
        "request_id": {
          "type": "string",
          "description": "Stable request trace identifier."
        },
        "server_version": {
          "type": "string",
          "description": "Deployed source revision when available."
        },
        "serialization_ms": {
          "type": "integer",
          "description": "Response serialization time in milliseconds."
        },
        "server_uptime_ms": {
          "type": "integer",
          "description": "Server process uptime in milliseconds."
        },
        "server_instance_id": {
          "type": "string",
          "description": "Ephemeral server-process identifier."
        }
      },
      "description": "Secret-safe request, trace, size, timing, and warning metadata.",
      "additionalProperties": true
    }
  },
  "description": "Qdrant MCP normalized 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": "qdrant-get-tool-usage-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.get_tool_usage",
    "arguments": {
      "tool": "",
      "tool_name": ""
    }
  }
}'

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": "qdrant-get-tool-usage-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.get_tool_usage",
    "arguments": {
      "tool": "",
      "tool_name": ""
    }
  }
}),
});
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": "qdrant-get-tool-usage-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.get_tool_usage",
    "arguments": {
      "tool": "",
      "tool_name": ""
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool qdrant.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."
}