Weaviate Docs MCP Server

The Weaviate Docs MCP Server brings instant access to Weaviate's documentation directly into your AI development environment. Built on the Model Context Protocol (MCP), this server integrates seamlessly with tools like Claude Desktop and Cursor, allowing you to query Weaviate's documentation without leaving your IDE.

The MCP server uses Kapa.ai (which in turn uses Weaviate under the hood) as its knowledge engine, which powers the search and retrieval of Weaviate documentation. The server offers:

Instant documentation access: Search Weaviate docs without context switching.
Multi-source knowledge base: Queries across docs, tutorials, API references, GitHub issues and community content.
Always up-to-date: Automatically syncs with the latest Weaviate documentation.

How to setup MCP Server

Setup steps vary depending on which AI assistant you're using.

Add the following to your .cursor/mcp.json file:

JSON

{
  "mcpServers": {
    "weaviate-docs": {
      "type": "http",
      "url": "https://weaviate-docs.mcp.kapa.ai"
    }
  }
}

Prerequisites: VS Code 1.102+ with GitHub Copilot enabled.

Create an mcp.json file in your workspace .vscode folder:

JSON

{
  "servers": {
    "weaviate-docs": {
      "type": "http",
      "url": "https://weaviate-docs.mcp.kapa.ai"
    }
  }
}

Run the following command in your terminal:

Bash

claude mcp add --transport http weaviate-docs https://weaviate-docs.mcp.kapa.ai

Then run the /mcp command in Claude Code and follow the steps in your browser to authenticate.

For more information, see the Claude Code MCP documentation.

ChatGPT Desktop supports MCP servers in developer mode:

Open ChatGPT Desktop.
Go to Settings > Apps > Advanced settings.
Enable Developer mode.
Navigate to Settings > Connectors.
Click Create and enter:

Name: Weaviate Docs
URL: https://weaviate-docs.mcp.kapa.ai

For more information, see the ChatGPT Desktop MCP documentation.

Claude Desktop supports MCP servers:

Open Claude Desktop.
Go to Settings > Connectors.
Click Add custom connector and enter:

Name: Weaviate Docs
URL: https://weaviate-docs.mcp.kapa.ai

Click on Connect and follow the steps in your browser to authenticate.

Restart Claude Desktop for changes to take effect.

For more details, see the Claude Desktop documentation.

MCP is an open protocol supported by many clients. Use the server URL https://weaviate-docs.mcp.kapa.ai and refer to your client's documentation for setup instructions.

Most clients accept the standard MCP JSON configuration format:

JSON

{
  "mcpServers": {
    "weaviate-docs": {
      "url": "https://weaviate-docs.mcp.kapa.ai"
    }
  }
}

Using the MCP Server

Once configured, you can ask context-aware questions about Weaviate from within your editor. For example:

"How do I set up a hybrid search in Weaviate?"

"What are the best practices for schema design in Weaviate?"

"Search the Weaviate docs for information about BM25 algorithm"

"What's the difference between vector and keyword search in Weaviate?"

Troubleshooting

Server not showing up

Check that the file path is correct for your OS
Restart the app completely
Ensure the URL is entered correctly
Verify the config file syntax is valid JSON

Connection errors

If you see connection errors:

Verify the server URL is accessible:
Bash
```
curl https://weaviate-docs.mcp.kapa.ai
```
Check your internet connection
Try the MCP Inspector to debug:
Bash
```
npx @modelcontextprotocol/inspector
```

No results returned

If queries return empty results:

Check that your question is relevant to Weaviate documentation
Try rephrasing your query
Verify the MCP server is properly configured (test with curl)

Rate limiting

The public Weaviate MCP server may have rate limits. If you experience issues:

Wait a few minutes before trying again

Further resources

Questions and feedback

Have a question or feedback? Here's how to reach us.

Community Forum

Ask questions and connect with other developers on our Community forum.

Support

Weaviate Cloud user or customer? Find the right channel on the Support page.