Qdrant Promote Short Term

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

DESTRUCTIVEqdrant.qdrant-promote-short-term

• Contract tier: agent_ready
• Risk: destructive
• Catalog version: qdrant-2026.07.12.2
• Descriptor hash: f4ede5ac0490fb5fa91a3bec6bb44c8b4f57a7b029822ca3e9bf59a245f57f89

Use this when you need to copy selected short-term memories into a long-term collection and optionally remove their source records. It can overwrite, remove, cancel, restore, or otherwise irreversibly change state and therefore requires the manifest-defined Portal confirmation. 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-promote-short-term-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.qdrant-promote-short-term",
    "arguments": {
      "point_ids": [],
      "clear_ttl": false,
      "remove_source": false,
      "metadata_patch": "",
      "source_collection": "",
      "target_collection": ""
    }
  }
}

Arguments Schema

{
  "type": "object",
  "title": "Qdrant Promote Short Term input",
  "required": [
    "point_ids"
  ],
  "properties": {
    "clear_ttl": {
      "type": "boolean",
      "title": "Clear Ttl",
      "default": true,
      "description": "Clear expires_at/ttl_days fields when promoting to long-term."
    },
    "point_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Point Ids",
      "description": "Point ids to promote from short-term memory."
    },
    "remove_source": {
      "type": "boolean",
      "title": "Remove Source",
      "default": false,
      "description": "Delete promoted points from short-term collection."
    },
    "metadata_patch": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Metadata Patch",
      "default": null,
      "description": "Optional metadata overrides to apply on promote."
    },
    "source_collection": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Collection",
      "default": null,
      "description": "Optional short-term collection override (defaults to MCP_SHORT_TERM_COLLECTION)."
    },
    "target_collection": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Target Collection",
      "default": null,
      "description": "Target collection for long-term storage (defaults to server collection)."
    }
  },
  "description": "Validated input contract for the qdrant-promote-short-term 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-promote-short-term: copy selected short-term memories into a long-term collection and optionally remove their source records.",
      "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-promote-short-term-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.qdrant-promote-short-term",
    "arguments": {
      "point_ids": [],
      "clear_ttl": false,
      "remove_source": false,
      "metadata_patch": "",
      "source_collection": "",
      "target_collection": ""
    }
  }
}'

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-promote-short-term-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.qdrant-promote-short-term",
    "arguments": {
      "point_ids": [],
      "clear_ttl": false,
      "remove_source": false,
      "metadata_patch": "",
      "source_collection": "",
      "target_collection": ""
    }
  }
}),
});
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-promote-short-term-example",
  "method": "tools/call",
  "params": {
    "name": "qdrant.qdrant-promote-short-term",
    "arguments": {
      "point_ids": [],
      "clear_ttl": false,
      "remove_source": false,
      "metadata_patch": "",
      "source_collection": "",
      "target_collection": ""
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

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