Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Databases - official Weaviate server

Weaviate MCP server

MCP server built into the Weaviate database binary, served over Streamable HTTP at /v1/mcp on the REST API port. Agents can inspect collection schemas, list tenants, run hybrid searches and, when write access is on, upsert objects, all under Weaviate auth and RBAC. It is served from your own instance at https://<your-cluster-host>/v1/mcp with API key auth.

Last verified 4 tools9 sources

Install

Claude Code

About Claude Code
Terminal
claude mcp add-json weaviate-local '{"type":"http","url":"http://localhost:8080/v1/mcp","headers":{"Authorization":"Bearer YOUR_API_KEY"}}'

Cursor

About Cursor
JSON
{
  "mcpServers": {
    "weaviate-local": {
      "type": "streamable-http",
      "url": "http://localhost:8080/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

JSON
{
  "servers": {
    "weaviate-local": {
      "type": "streamable-http",
      "url": "http://localhost:8080/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Generic

JSON
{
  "mcpServers": {
    "weaviate-local": {
      "url": "http://localhost:8080/v1/mcp",
      "type": "streamable-http"
    }
  }
}

Tools

weaviate-collections-get-config
Retrieves the schema configuration for one or all collections.
weaviate-tenants-list
Lists tenants and their activity status for a multi-tenant collection.
weaviate-query-hybrid
Hybrid search combining vector similarity and BM25 keyword matching, with filters and named vectors.
weaviate-objects-upsert
Batch inserts or replaces objects (only when write access is enabled).

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Preview in v1.37, general availability in v1.38 (per the 1.38 release post).
  • Self-hosted: off by default, turn it on with MCP_SERVER_ENABLED=true and write tools with MCP_SERVER_WRITE_ACCESS_ENABLED=true.
  • Weaviate Cloud: always on, upsert available unless the cluster-wide 'Enable MCP Read-Only' switch is set.
  • Clusters using Weaviate Embeddings also need the X-Weaviate-Cluster-Url header.
  • RBAC needs the read_mcp/create_mcp/update_mcp permissions.
  • Claude Desktop needs the third-party mcp-proxy bridge.
  • The older standalone Go repo weaviate/mcp-server-weaviate is deprecated and unmaintained.

More MCP servers for databases

Related reading

FAQ

What does the Weaviate MCP server do?

MCP server built into the Weaviate database binary, served over Streamable HTTP at /v1/mcp on the REST API port. Agents can inspect collection schemas, list tenants, run hybrid searches and, when write access is on, upsert objects, all under Weaviate auth and RBAC. The vendor documents 4 tools, including weaviate-collections-get-config, weaviate-tenants-list, weaviate-query-hybrid and weaviate-objects-upsert.

How do I add the Weaviate MCP server to Claude Code?

Run claude mcp add-json weaviate-local '{"type":"http","url":"http://localhost:8080/v1/mcp","headers":{"Authorization":"Bearer YOUR_API_KEY"}}', copied from Weaviate's docs. This page also has snippets for Cursor, VS Code and Generic.

Does the Weaviate MCP server need authentication?

Yes, API key. Transport: Streamable HTTP. Status: GA, last checked October 17, 2026.

Sources

Last verified against 9 Weaviate pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.