Qdrant Suggest Filters

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READqdrant.qdrant-suggest-filters

• Contract tier: agent_ready
• Risk: read
• Catalog version: qdrant-2026.07.12.2
• Descriptor hash: 9b797f03f4ba6ecc3190169424ae805dca5b811bbe0ae5786604e4e57c0f16aa

Use this when you need to sample indexed metadata values and suggest exact retrieval filters. It does not intentionally change Qdrant or MCP state. It contacts the configured Qdrant service or uses MCP-owned job/upload state. 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-qdrant-suggest-filters-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.qdrant-suggest-filters",
    "arguments": {
      "query": "",
      "fields": "",
      "sample_limit": 1,
      "collection_name": "",
      "max_values_per_field": 1
    }
  }
}

Arguments Schema

{
  "type": "object",
  "title": "Qdrant Suggest Filters input",
  "properties": {
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Query",
      "default": null,
      "description": "Optional task/query text. Sample values found inside this text are returned as recommended filters."
    },
    "fields": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Fields",
      "default": null,
      "description": "Optional metadata fields to inspect. Defaults to indexed fields that qdrant memory filters understand."
    },
    "sample_limit": {
      "type": "integer",
      "title": "Sample Limit",
      "default": 25,
      "description": "Max payload samples to inspect, clamped to 0-100."
    },
    "collection_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Collection Name",
      "default": null,
      "description": "Collection to inspect for useful exact filters."
    },
    "max_values_per_field": {
      "type": "integer",
      "title": "Max Values Per Field",
      "default": 8,
      "description": "Max distinct sample values per field, clamped to 1-20."
    }
  },
  "description": "Validated input contract for the qdrant-suggest-filters native Qdrant MCP tool."
}

Output Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "object",
      "description": "Normalized result data for qdrant-suggest-filters: sample indexed metadata values and suggest exact retrieval filters.",
      "additionalProperties": true
    },
    "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-qdrant-suggest-filters-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.qdrant-suggest-filters",
    "arguments": {
      "query": "",
      "fields": "",
      "sample_limit": 1,
      "collection_name": "",
      "max_values_per_field": 1
    }
  }
}'

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-qdrant-suggest-filters-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.qdrant-suggest-filters",
    "arguments": {
      "query": "",
      "fields": "",
      "sample_limit": 1,
      "collection_name": "",
      "max_values_per_field": 1
    }
  }
}),
});
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-qdrant-suggest-filters-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.qdrant-suggest-filters",
    "arguments": {
      "query": "",
      "fields": "",
      "sample_limit": 1,
      "collection_name": "",
      "max_values_per_field": 1
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

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