Skip to main content

Qdrant Find Tools

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READqdrant.qdrant-find-tools
  • Contract tier: legacy
  • Risk: read
  • Catalog version: qdrant-2026.07.12.2
  • Descriptor hash: dcf9e5236e57ddc96b7c66fc9a4e26422f04e6537672361fd432b8e605a98b42

Use this when you need to find Qdrant tools for a multi-word task using deterministic local catalog search. 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. Prefer its typed replacement when one is available because this tool remains in the legacy tier.

Request Body​

{
  "jsonrpc": "2.0",
  "id": "qdrant-qdrant-find-tools-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.qdrant-find-tools",
    "arguments": {
      "query": "query_example",
      "risk": "risk_example",
      "limit": 1,
      "category": "category_example",
      "include_legacy": false
    }
  }
}

Arguments Schema​

{
  "type": "object",
  "title": "Qdrant Find Tools input",
  "required": [
    "query"
  ],
  "properties": {
    "risk": {
      "type": "string",
      "title": "Risk",
      "default": "",
      "description": "Optional risk filter: read, write, or destructive."
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 8,
      "maximum": 25,
      "minimum": 1,
      "description": "Maximum ranked results to return, from 1 through 25."
    },
    "query": {
      "type": "string",
      "title": "Query",
      "description": "Natural-language task or tool terms; every punctuation-normalized token must match the descriptor."
    },
    "category": {
      "type": "string",
      "title": "Category",
      "default": "",
      "description": "Optional exact ToolManifest category filter; empty includes every category."
    },
    "include_legacy": {
      "type": "boolean",
      "title": "Include Legacy",
      "default": false,
      "description": "When true, include legacy tools; hidden tools remain excluded."
    }
  },
  "description": "Validated input contract for the qdrant-find-tools 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": [
        "query",
        "count",
        "matches"
      ],
      "properties": {
        "count": {
          "type": "integer",
          "description": "Number of returned matches."
        },
        "query": {
          "type": "string",
          "description": "Normalized caller search task."
        },
        "matches": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Ranked compact descriptor matches."
        }
      },
      "description": "Deterministically ranked Qdrant tool matches.",
      "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 -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "qdrant-qdrant-find-tools-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.qdrant-find-tools",
    "arguments": {
      "query": "query_example",
      "risk": "risk_example",
      "limit": 1,
      "category": "category_example",
      "include_legacy": false
    }
  }
}'

Example Responses​

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