Agent mode

YDB-Qdrant Agent Mode

YDB-Qdrant is a Qdrant-compatible vector search REST API and Node.js library backed by YDB. Use it for semantic search, RAG prototypes, IDE-agent memory, and YDB-backed applications that need vector storage without a separate vector database cluster. This page is the human-readable agent-mode view. Use /agent-mode.json for the compact machine-readable JSON version.

Agent JSON OpenAPI Developer hub

API contract

Current API version is 2026-05-28. Agents may send YDB-Qdrant-API-Version to pin the documented contract.

OpenAPI specification
REST API docs
https://ydb-qdrant.tech: Public HTTPS API proxy for health, collection, and point routes.
http://ydb-qdrant.tech:8080: HTTP-only public demo Qdrant-compatible base URL. Use only with non-sensitive demo credentials.
http://localhost:8080: Self-hosted local server.

REST endpoints

GET /health
PUT /collections/{collection}
GET /collections/{collection}
DELETE /collections/{collection}
PUT /collections/{collection}/index
POST /collections/{collection}/points
PUT /collections/{collection}/points
POST /collections/{collection}/points/upsert
POST /collections/{collection}/points/search
POST /collections/{collection}/points/query
POST /collections/{collection}/points/delete

Authentication

api-key: <namespace-key>
X-Tenant-Id: optional-workspace
YDB-Qdrant-API-Version: 2026-05-28
Idempotency-Key: stable-mutation-key
Authorization: Bearer <code-indexer-mcp-token>

api-key defines the namespace boundary for collections and points.
X-Tenant-Id optionally splits one api-key into workspace or tenant namespaces.
YDB-Qdrant-API-Version can pin the current documented REST contract.
Idempotency-Key should be reused for the same intended mutation when an agent retries.
Hosted MCP is for YDB Qdrant Code Indexer read-only repository memory.
MCP tokens are created in the dashboard and scoped by GitHub App repository access.
The root vector REST product does not expose hosted MCP vector mutation tools.

Capabilities

Qdrant-compatible REST subset for collection lifecycle and point operations.
Exact top-k vector search over YDB-backed data.
Node.js library mode through the ydb-qdrant package.
Hosted Code Indexer MCP for read-only repository search.
Agent-readable OpenAPI, llms.txt, agent card, API catalog, and skill files.

Known limits

Not full Qdrant parity.
No root-product hosted MCP server for vector mutations.
No OAuth scopes or role-based REST permissions are currently enforced.
Use another search platform when you need mature hybrid lexical/vector search, faceting, analyzers, or specialized ANN indexing at production scale.

Recommended agent flow

Read https://ydb-qdrant.tech/openapi.json before generating calls.
Send api-key on REST requests and optionally X-Tenant-Id for workspace isolation.
Send YDB-Qdrant-API-Version: 2026-05-28 when pinning the current documented contract.
Create or confirm a collection before point writes.
Use Idempotency-Key on retried mutation requests.
Search with POST /collections/{collection}/points/search.
Use Code Indexer MCP only for read-only repository memory.