Weaviate MCP Server

Weaviate's MCP server is not a package you install; it is part of the database. From v1.38 the Model Context Protocol server is generally available inside the main weaviate/weaviate binary, served as a streamable HTTP endpoint at /v1/mcp on the same port as the REST API. For anyone already running Weaviate, that removes the usual sidecar: no separate process to deploy, version-match or keep credentialed.

Off by default, on without a restart

The server is disabled by default as a deliberate security posture. Set MCP_SERVER_ENABLED=true to turn it on, and MCP_SERVER_WRITE_ACCESS_ENABLED=true if you want the agent to be able to write. Both flags became runtime-configurable in v1.38, so you can grant or revoke agent access to a live cluster without a restart — useful when write access should be a temporary, deliberate act rather than a permanent deployment property.

Four tools, scoped by RBAC

Authentication uses Weaviate's existing bearer/API-key flow and every call respects the instance's standard RBAC permissions, so an agent inherits exactly the entitlements of the key it presents. The tools are deliberately few:

• weaviate-collections-get-config — read the schema configuration of collections, so the agent can discover what exists before querying it
• weaviate-tenants-list — enumerate tenants in multi-tenant collections
• weaviate-query-hybrid — hybrid search combining vector similarity with BM25 keyword matching, which is the retrieval mode most production Weaviate setups actually use
• weaviate-objects-upsert — batch insert and update objects, available only when write access is enabled

Clients

Claude Code adds it with claude mcp add-json using an HTTP transport and an Authorization header; Cursor and VS Code take an equivalent streamable-HTTP block in .cursor/mcp.json or .vscode/mcp.json. Claude Desktop needs an mcp-proxy bridge, since it expects STDIO rather than HTTP.

Status

Previewed in v1.37.1 and promoted to general availability in v1.38, released 25 June 2026 alongside the HFresh vector index. Weaviate is open source under BSD-3-Clause.