---
title: "Weaviate built-in MCP: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/weaviate/
description: "Inspect collections, search vector and keyword data, and optionally upsert objects through Weaviate’s built-in MCP endpoint."
---

# Weaviate built-in MCP: review, setup & limitations · Undominated.ai

> Inspect collections, search vector and keyword data, and optionally upsert objects through Weaviate’s built-in MCP endpoint.

[← Explore all mcp servers](/mcp-servers/)

VECTOR DATA MANAGEMENT / Weaviate

# Weaviate built-in MCP

Inspect collections, search vector and keyword data, and optionally upsert objects through Weaviate’s built-in MCP endpoint.

 [See setup guidance ↓](#setup)[Original source ↗](https://docs.weaviate.io/weaviate/configuration/mcp-server)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 7 linked sources
 Publisher Weaviate
 Licence [BSD-3-Clause (built-in MCP source outside wl) ↗](https://raw.githubusercontent.com/weaviate/weaviate/69fd5307a49b1e3119915bc4621f17654773b429/LICENSE-BSD)
 Revision 69fd5307a49b
 [Read what was—and wasn’t—checked ↓](#review)

“Weaviate implements this as a Streamable HTTP server that runs on the same port as the main Weaviate REST API.”

 [Weaviate · upstream description ↗](https://docs.weaviate.io/weaviate/configuration/mcp-server) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Lives in the database server and reuses its authentication and role permissions.
- Collection and tenant inspection support retrieval against existing Weaviate data.

### A good fit for

 - Query a Weaviate collection from an agent.
- Perform explicitly approved object updates with a restricted database identity.

### Weigh up before choosing

 - The old standalone MCP repository is deprecated; this entry covers the built-in server.
- Self-hosted MCP is disabled by default and read-only when enabled (MCP_SERVER_WRITE_ACCESS_ENABLED defaults to false). On Weaviate Cloud the MCP server is always enabled with no switch to turn it off, and weaviate-objects-upsert is available until the cluster’s Enable MCP Read-Only switch is set.
- Upsert replaces objects rather than merging properties, and auto-schema can create fields or collections. Review full objects before writing.
- A mistyped collection name in an upsert creates a new collection while auto-schema is on, per the docs; set AUTOSCHEMA_ENABLED=false if the MCP server must not change the schema.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - Current Weaviate MCP configuration and tool reference (docs.weaviate.io, read 2026-10-13).
- Standalone mcp-server-weaviate README at 2122c8fc0f4ffdef19b1b24dc71fde69255adca8 (deprecation notice).
- adapters/handlers/mcp/server.go, auth/auth.go and create/objects_upsert.go in weaviate/weaviate at 69fd5307a49b1e3119915bc4621f17654773b429.
- LICENSE and LICENSE-BSD at 69fd5307a49b1e3119915bc4621f17654773b429.

### Our findings

 - The endpoint is /v1/mcp on the REST API host. RBAC is enforced when tools are called, not by hiding every unauthorized tool in tools/list.
- The inspected MCP source is outside wl and covered by BSD-3-Clause; that does not extend to separately licensed Weaviate features.
- At this commit LICENSE says code under wl/ is all rights reserved and available only under a separate enterprise licence (it said "Weaviate License" at the previous pin). adapters/handlers/mcp is outside wl, so the MCP handler stays BSD-3-Clause.
- Four tools: weaviate-collections-get-config, weaviate-tenants-list, weaviate-query-hybrid and weaviate-objects-upsert. Only the write-access flag hides the upsert tool; a call the key may not make returns a tool result with isError true, not HTTP 403.
- auth.go now also requires the collection’s namespace to be active before authorizing a call (AuthorizeAndRequireActiveNamespace). The docs page says the server was added in v1.38; the standalone README says preview from v1.37.1.
- configExample is the docs page’s "Standard JSON configuration format" block, read 2026-10-13. It carries no Authorization header; the docs say to send Authorization: Bearer with an API key unless anonymous access is enabled.

### Not established by this review

 - Server launch, authenticated tool calls, and release-to-source parity were not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://docs.weaviate.io/weaviate/configuration/mcp-server)
 - Use a Weaviate deployment that includes the built-in server; do not install the deprecated standalone package.
- For self-hosting, enable MCP_SERVER_ENABLED and leave write access disabled unless needed. In Cloud, configure Enable MCP Read-Only if the agent should only read.
- Connect to the REST host with /v1/mcp and a suitable API key using the official client-specific instructions.

### Before you start

 - A supported Weaviate deployment.
- An API key with appropriate MCP and data permissions; transport-capable client.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

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

### Compatibility

Claude Code · Cursor · VS Code · Streamable HTTP clients

### Implementation

Go

### Transports

Streamable HTTP

### Database API key and RBAC

 - Reads collection configuration, tenant metadata and search results.
- Upserts objects when write access and the key’s permissions allow it; auto-schema can extend the schema.
- Authenticates with a Weaviate API key as a Bearer token; under RBAC, reads need read_mcp plus data permissions and upserts need create_mcp and update_mcp. The predefined viewer role gives read-only MCP access.

### Cost model

Self-hosting or Weaviate Cloud usage, embedding services and the AI client have separate costs.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Weaviate built-in MCP setup and scope ↗](https://docs.weaviate.io/weaviate/configuration/mcp-server) Checked 2026-10-13 https://docs.weaviate.io/weaviate/configuration/mcp-server Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review, configExample
- [Deprecated standalone Weaviate server notice ↗](https://raw.githubusercontent.com/weaviate/mcp-server-weaviate/2122c8fc0f4ffdef19b1b24dc71fde69255adca8/README.md) Checked 2026-10-13 https://raw.githubusercontent.com/weaviate/mcp-server-weaviate/2122c8fc0f4ffdef19b1b24dc71fde69255adca8/README.md Supports: limitations, review
- [Built-in Weaviate MCP server ↗](https://raw.githubusercontent.com/weaviate/weaviate/69fd5307a49b1e3119915bc4621f17654773b429/adapters/handlers/mcp/server.go) Checked 2026-10-13 https://raw.githubusercontent.com/weaviate/weaviate/69fd5307a49b1e3119915bc4621f17654773b429/adapters/handlers/mcp/server.go Supports: language, transports, review
- [Weaviate MCP authorization ↗](https://raw.githubusercontent.com/weaviate/weaviate/69fd5307a49b1e3119915bc4621f17654773b429/adapters/handlers/mcp/auth/auth.go) Checked 2026-10-13 https://raw.githubusercontent.com/weaviate/weaviate/69fd5307a49b1e3119915bc4621f17654773b429/adapters/handlers/mcp/auth/auth.go Supports: access, review
- [Weaviate object upsert handler ↗](https://raw.githubusercontent.com/weaviate/weaviate/69fd5307a49b1e3119915bc4621f17654773b429/adapters/handlers/mcp/create/objects_upsert.go) Checked 2026-10-13 https://raw.githubusercontent.com/weaviate/weaviate/69fd5307a49b1e3119915bc4621f17654773b429/adapters/handlers/mcp/create/objects_upsert.go Supports: access, review
- [Weaviate licence scope by path ↗](https://raw.githubusercontent.com/weaviate/weaviate/69fd5307a49b1e3119915bc4621f17654773b429/LICENSE) Checked 2026-10-13 https://raw.githubusercontent.com/weaviate/weaviate/69fd5307a49b1e3119915bc4621f17654773b429/LICENSE Supports: license
- [BSD terms for built-in MCP source ↗](https://raw.githubusercontent.com/weaviate/weaviate/69fd5307a49b1e3119915bc4621f17654773b429/LICENSE-BSD) Checked 2026-10-13 https://raw.githubusercontent.com/weaviate/weaviate/69fd5307a49b1e3119915bc4621f17654773b429/LICENSE-BSD Supports: license

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Pinecone MCP ↗ Search Pinecone documentation and manage or query indexes that use integrated embeddings.](/mcp-servers/pinecone/)[### Chroma MCP ↗ Lets an assistant create and query Chroma collections through local, HTTP or Chroma Cloud database connections.](/mcp-servers/chroma/)[### Zilliz MCP Server ↗ Manages Zilliz Cloud projects and clusters and works with data in Milvus collections (create, insert, delete, vector and hybrid search) from an MCP client.](/mcp-servers/zilliz-cloud-mcp/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
