Can I use Qdrant as a CLI?

Yes. KosmoKrator exposes a Qdrant CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Qdrant through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Qdrant tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Qdrant credentials stored?

Qdrant credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Qdrant MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

data

Qdrant CLI for AI Agents

Use the Qdrant CLI from KosmoKrator to call Qdrant tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

Qdrant CLI Setup

Qdrant can be configured headlessly with `kosmokrator integrations:configure qdrant`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure qdrant --set api_key="$QDRANT_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor qdrant --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`api_key`	`QDRANT_API_KEY`	Secret `secret`	yes	API Key
`url`	`QDRANT_URL`	URL `url`	no	Cluster URL

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call qdrant.qdrant_list_collections '{}' --json

Provider shortcut

kosmo integrations:qdrant qdrant_list_collections '{}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs qdrant --json
kosmo integrations:docs qdrant.qdrant_list_collections --json
kosmo integrations:schema qdrant.qdrant_list_collections --json
kosmo integrations:search "Qdrant" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`qdrant.qdrant_list_collections`

List all vector collections in the Qdrant cluster. Returns collection names and basic metadata.

Read read

Parameters: none

Generic call

kosmo integrations:call qdrant.qdrant_list_collections '{}' --json

Shortcut

kosmo integrations:qdrant qdrant_list_collections '{}' --json

`qdrant.qdrant_get_collection`

Get detailed information about a specific Qdrant collection, including vector configuration, index status, and point count.

Read read

Parameters: name

Generic call

kosmo integrations:call qdrant.qdrant_get_collection '{"name":"example_name"}' --json

Shortcut

kosmo integrations:qdrant qdrant_get_collection '{"name":"example_name"}' --json

`qdrant.qdrant_create_collection`

Create a new vector collection in Qdrant. You must specify the vector configuration (size, distance metric). Optionally provide HNSW, quantization, and optimization settings.

Write write

Parameters: name, vectors, hnsw_config, optimizers_config, quantization_config, replication_factor, shard_number

Generic call

kosmo integrations:call qdrant.qdrant_create_collection '{"name":"example_name","vectors":"example_vectors","hnsw_config":"example_hnsw_config","optimizers_config":"example_optimizers_config","quantization_config":"example_quantization_config","replication_factor":1,"shard_number":1}' --json

Shortcut

kosmo integrations:qdrant qdrant_create_collection '{"name":"example_name","vectors":"example_vectors","hnsw_config":"example_hnsw_config","optimizers_config":"example_optimizers_config","quantization_config":"example_quantization_config","replication_factor":1,"shard_number":1}' --json

`qdrant.qdrant_delete_collection`

Delete a Qdrant collection and all of its points.

Write write

Parameters: name, timeout

Generic call

kosmo integrations:call qdrant.qdrant_delete_collection '{"name":"example_name","timeout":1}' --json

Shortcut

kosmo integrations:qdrant qdrant_delete_collection '{"name":"example_name","timeout":1}' --json

`qdrant.qdrant_search`

Search for the closest vectors in a Qdrant collection. Supports vector similarity search with optional filtering, payload selection, and scoring.

Read read

Parameters: collection, vector, vector_name, filter, limit, offset, with_payload, with_vectors, score_threshold

Generic call

kosmo integrations:call qdrant.qdrant_search '{"collection":"example_collection","vector":"example_vector","vector_name":"example_vector_name","filter":"example_filter","limit":1,"offset":1,"with_payload":true,"with_vectors":true}' --json

Shortcut

kosmo integrations:qdrant qdrant_search '{"collection":"example_collection","vector":"example_vector","vector_name":"example_vector_name","filter":"example_filter","limit":1,"offset":1,"with_payload":true,"with_vectors":true}' --json

`qdrant.qdrant_query_points`

Use Qdrant Query API for nearest, recommend, discover, fusion, or multi-stage vector queries.

Read read

Parameters: collection, query, using, filter, params, limit, offset, with_payload, with_vector, score_threshold

Generic call

kosmo integrations:call qdrant.qdrant_query_points '{"collection":"example_collection","query":"example_query","using":"example_using","filter":"example_filter","params":"example_params","limit":1,"offset":1,"with_payload":true}' --json

Shortcut

kosmo integrations:qdrant qdrant_query_points '{"collection":"example_collection","query":"example_query","using":"example_using","filter":"example_filter","params":"example_params","limit":1,"offset":1,"with_payload":true}' --json

`qdrant.qdrant_retrieve_points`

Retrieve Qdrant points by IDs with optional payload and vector selection.

Read read

Parameters: collection, ids, with_payload, with_vector

Generic call

kosmo integrations:call qdrant.qdrant_retrieve_points '{"collection":"example_collection","ids":"example_ids","with_payload":true,"with_vector":true}' --json

Shortcut

kosmo integrations:qdrant qdrant_retrieve_points '{"collection":"example_collection","ids":"example_ids","with_payload":true,"with_vector":true}' --json

`qdrant.qdrant_scroll_points`

Scroll Qdrant points with optional filters, payload selection, and offset pagination.

Read read

Parameters: collection, filter, limit, offset, with_payload, with_vector

Generic call

kosmo integrations:call qdrant.qdrant_scroll_points '{"collection":"example_collection","filter":"example_filter","limit":1,"offset":"example_offset","with_payload":true,"with_vector":true}' --json

Shortcut

kosmo integrations:qdrant qdrant_scroll_points '{"collection":"example_collection","filter":"example_filter","limit":1,"offset":"example_offset","with_payload":true,"with_vector":true}' --json

`qdrant.qdrant_count_points`

Count points in a Qdrant collection, optionally matching a filter exactly or approximately.

Read read

Parameters: collection, filter, exact

Generic call

kosmo integrations:call qdrant.qdrant_count_points '{"collection":"example_collection","filter":"example_filter","exact":true}' --json

Shortcut

kosmo integrations:qdrant qdrant_count_points '{"collection":"example_collection","filter":"example_filter","exact":true}' --json

`qdrant.qdrant_upsert_points`

Insert or update points (vectors with optional payloads) in a Qdrant collection. Each point requires an ID and a vector. Payloads are optional metadata.

Write write

Parameters: collection, points, wait, ordering

Generic call

kosmo integrations:call qdrant.qdrant_upsert_points '{"collection":"example_collection","points":"example_points","wait":true,"ordering":"example_ordering"}' --json

Shortcut

kosmo integrations:qdrant qdrant_upsert_points '{"collection":"example_collection","points":"example_points","wait":true,"ordering":"example_ordering"}' --json

`qdrant.qdrant_delete_points`

Delete Qdrant points by point IDs or filter selector.

Write write

Parameters: collection, points, filter, wait, ordering

Generic call

kosmo integrations:call qdrant.qdrant_delete_points '{"collection":"example_collection","points":"example_points","filter":"example_filter","wait":true,"ordering":"example_ordering"}' --json

Shortcut

kosmo integrations:qdrant qdrant_delete_points '{"collection":"example_collection","points":"example_points","filter":"example_filter","wait":true,"ordering":"example_ordering"}' --json

`qdrant.qdrant_set_payload`

Set payload values on Qdrant points selected by IDs or filter.

Write write

Parameters: collection, payload, points, filter, wait

Generic call

kosmo integrations:call qdrant.qdrant_set_payload '{"collection":"example_collection","payload":"example_payload","points":"example_points","filter":"example_filter","wait":true}' --json

Shortcut

kosmo integrations:qdrant qdrant_set_payload '{"collection":"example_collection","payload":"example_payload","points":"example_points","filter":"example_filter","wait":true}' --json

`qdrant.qdrant_delete_payload`

Delete specific payload keys from points selected by IDs or filter.

Write write

Parameters: collection, keys, points, filter, wait

Generic call

kosmo integrations:call qdrant.qdrant_delete_payload '{"collection":"example_collection","keys":"example_keys","points":"example_points","filter":"example_filter","wait":true}' --json

Shortcut

kosmo integrations:qdrant qdrant_delete_payload '{"collection":"example_collection","keys":"example_keys","points":"example_points","filter":"example_filter","wait":true}' --json

`qdrant.qdrant_clear_payload`

Clear all payload fields from points selected by IDs or filter.

Write write

Parameters: collection, points, filter, wait

Generic call

kosmo integrations:call qdrant.qdrant_clear_payload '{"collection":"example_collection","points":"example_points","filter":"example_filter","wait":true}' --json

Shortcut

kosmo integrations:qdrant qdrant_clear_payload '{"collection":"example_collection","points":"example_points","filter":"example_filter","wait":true}' --json

`qdrant.qdrant_create_payload_index`

Create a payload index for a collection field to speed up filtering.

Write write

Parameters: collection, field_name, field_schema

Generic call

kosmo integrations:call qdrant.qdrant_create_payload_index '{"collection":"example_collection","field_name":"example_field_name","field_schema":"example_field_schema"}' --json

Shortcut

kosmo integrations:qdrant qdrant_create_payload_index '{"collection":"example_collection","field_name":"example_field_name","field_schema":"example_field_schema"}' --json

`qdrant.qdrant_delete_payload_index`

Delete a payload index from a Qdrant collection field.

Write write

Parameters: collection, field_name

Generic call

kosmo integrations:call qdrant.qdrant_delete_payload_index '{"collection":"example_collection","field_name":"example_field_name"}' --json

Shortcut

kosmo integrations:qdrant qdrant_delete_payload_index '{"collection":"example_collection","field_name":"example_field_name"}' --json

`qdrant.qdrant_get_cluster_info`

Get Qdrant cluster information, including peer state and cluster status where available.

Read read

Parameters: none

Generic call

kosmo integrations:call qdrant.qdrant_get_cluster_info '{}' --json

Shortcut

kosmo integrations:qdrant qdrant_get_cluster_info '{}' --json

`qdrant.qdrant_list_aliases`

List all Qdrant collection aliases in the cluster.

Read read

Parameters: none

Generic call

kosmo integrations:call qdrant.qdrant_list_aliases '{}' --json

Shortcut

kosmo integrations:qdrant qdrant_list_aliases '{}' --json

`qdrant.qdrant_list_collection_aliases`

List aliases attached to one Qdrant collection.

Read read

Parameters: collection

Generic call

kosmo integrations:call qdrant.qdrant_list_collection_aliases '{"collection":"example_collection"}' --json

Shortcut

kosmo integrations:qdrant qdrant_list_collection_aliases '{"collection":"example_collection"}' --json

`qdrant.qdrant_update_aliases`

Atomically create, delete, or rename Qdrant collection aliases.

Write write

Parameters: actions

Generic call

kosmo integrations:call qdrant.qdrant_update_aliases '{"actions":"example_actions"}' --json

Shortcut

kosmo integrations:qdrant qdrant_update_aliases '{"actions":"example_actions"}' --json

`qdrant.qdrant_list_snapshots`

List collection snapshots available in Qdrant.

Read read

Parameters: collection

Generic call

kosmo integrations:call qdrant.qdrant_list_snapshots '{"collection":"example_collection"}' --json

Shortcut

kosmo integrations:qdrant qdrant_list_snapshots '{"collection":"example_collection"}' --json

`qdrant.qdrant_create_snapshot`

Create a snapshot for a Qdrant collection.

Write write

Parameters: collection

Generic call

kosmo integrations:call qdrant.qdrant_create_snapshot '{"collection":"example_collection"}' --json

Shortcut

kosmo integrations:qdrant qdrant_create_snapshot '{"collection":"example_collection"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

qdrant.qdrant_list_collections 0 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_list_collections --json

Parameter	Type	Required	Description
No parameters.

qdrant.qdrant_get_collection 1 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_get_collection --json

Parameter	Type	Required	Description
`name`	string	yes	The name of the collection to retrieve.

qdrant.qdrant_create_collection 7 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_create_collection --json

Parameter	Type	Required	Description
`name`	string	yes	Name for the new collection.
`vectors`	object	yes	Vector configuration. Example: {"size": 1536, "distance": "Cosine"}. Distance options: Cosine, Euclid, Dot.
`hnsw_config`	object	no	HNSW index configuration (e.g., {"m": 16, "ef_construct": 100}).
`optimizers_config`	object	no	Optimizer configuration (e.g., {"indexing_threshold": 20000}).
`quantization_config`	object	no	Quantization configuration for memory savings (scalar or product).
`replication_factor`	integer	no	Number of replicas for each shard (default: 1).
`shard_number`	integer	no	Number of shards for the collection (default: 1 for single-node).

qdrant.qdrant_delete_collection 2 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_delete_collection --json

Parameter	Type	Required	Description
`name`	string	yes	Collection name.
`timeout`	integer	no	Optional operation timeout in seconds.

qdrant.qdrant_search 9 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_search --json

Parameter	Type	Required	Description
`collection`	string	yes	The collection name to search in.
`vector`	array	no	The query vector (array of floats). Use this for direct vector search.
`vector_name`	string	no	Named vector to search against (for multi-vector collections).
`filter`	object	no	Filter conditions to narrow results. JSON object with "must", "should", "must_not" clauses.
`limit`	integer	no	Maximum number of results to return (default: 10).
`offset`	integer	no	Offset for pagination.
`with_payload`	boolean	no	Whether to include point payloads in results (default: true).
`with_vectors`	boolean	no	Whether to include vectors in results (default: false).
`score_threshold`	number	no	Minimum similarity score threshold. Results below this are excluded.

qdrant.qdrant_query_points 10 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_query_points --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.
`query`	object	no	Query object or vector.
`using`	string	no	Named vector to query.
`filter`	object	no	Qdrant filter object.
`params`	object	no	Search params.
`limit`	integer	no	Maximum results.
`offset`	integer	no	Pagination offset.
`with_payload`	boolean	no	Include payloads.
`with_vector`	boolean	no	Include vectors.
`score_threshold`	number	no	Minimum score threshold.

qdrant.qdrant_retrieve_points 4 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_retrieve_points --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.
`ids`	array	yes	Point IDs to retrieve.
`with_payload`	boolean	no	Include payloads.
`with_vector`	boolean	no	Include vectors.

qdrant.qdrant_scroll_points 6 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_scroll_points --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.
`filter`	object	no	Optional filter.
`limit`	integer	no	Page size.
`offset`	string	no	Next offset from the previous response.
`with_payload`	boolean	no	Include payloads.
`with_vector`	boolean	no	Include vectors.

qdrant.qdrant_count_points 3 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_count_points --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.
`filter`	object	no	Optional filter.
`exact`	boolean	no	Whether to count exactly.

qdrant.qdrant_upsert_points 4 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_upsert_points --json

Parameter	Type	Required	Description
`collection`	string	yes	The collection name to upsert points into.
`points`	array	yes	Array of point objects. Each point must have "id" (integer or UUID string), "vector" (array of floats), and optionally "payload" (object with metadata).
`wait`	boolean	no	Whether to wait for the operation to complete (default: true).
`ordering`	string	no	Write ordering guarantee: "weak" or "strong" (default: "weak").

qdrant.qdrant_delete_points 5 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_delete_points --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.
`points`	array	no	Point IDs to delete.
`filter`	object	no	Filter selector for points to delete.
`wait`	boolean	no	Wait for completion.
`ordering`	string	no	Write ordering guarantee.

qdrant.qdrant_set_payload 5 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_set_payload --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.
`payload`	object	yes	Payload values to set.
`points`	array	no	Point IDs to update.
`filter`	object	no	Filter selector.
`wait`	boolean	no	Wait for completion.

qdrant.qdrant_delete_payload 5 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_delete_payload --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.
`keys`	array	yes	Payload keys to delete.
`points`	array	no	Point IDs to update.
`filter`	object	no	Filter selector.
`wait`	boolean	no	Wait for completion.

qdrant.qdrant_clear_payload 4 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_clear_payload --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.
`points`	array	no	Point IDs to update.
`filter`	object	no	Filter selector.
`wait`	boolean	no	Wait for completion.

qdrant.qdrant_create_payload_index 3 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_create_payload_index --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.
`field_name`	string	yes	Payload field name.
`field_schema`	object	yes	Qdrant field schema, e.g. keyword, integer, float, geo, bool, datetime, uuid, or text.

qdrant.qdrant_delete_payload_index 2 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_delete_payload_index --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.
`field_name`	string	yes	Payload field name.

qdrant.qdrant_get_cluster_info 0 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_get_cluster_info --json

Parameter	Type	Required	Description
No parameters.

qdrant.qdrant_list_aliases 0 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_list_aliases --json

Parameter	Type	Required	Description
No parameters.

qdrant.qdrant_list_collection_aliases 1 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_list_collection_aliases --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.

qdrant.qdrant_update_aliases 1 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_update_aliases --json

Parameter	Type	Required	Description
`actions`	array	yes	Alias operation actions.

qdrant.qdrant_list_snapshots 1 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_list_snapshots --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.

qdrant.qdrant_create_snapshot 1 parameters

Schema command

kosmo integrations:schema qdrant.qdrant_create_snapshot --json

Parameter	Type	Required	Description
`collection`	string	yes	Collection name.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.