mozg — Claude Code MCP server: what it does, how to install
mozg gives agents MCP access to scored knowledge brains. It retrieves relevant notes, exposes coverage gaps, and carries working state into another session.
claude mcp add --transport http mozg https://mozg.sh/mcpWhat mozg does
mozg connects an agent to knowledge brains over MCP. A documentation source is split into atomic notes with embeddings, then checked against an exam of roughly 30 questions derived from the brain’s goal. Failed questions guide another focused read, while searches with no result can become new exam questions.
Retrieval runs on the server with hybrid search and a reranker, so the agent receives the passages it needs. It can list available brains, inspect their summaries, and use brain_handoff to carry working state into a later session. Reader corrections enter as attributed proposals and stay out of search until the owner reviews them. Notes are scanned for leaked credentials, personal data, and prompt-injection language.
The hosted MCP endpoint can be added to Claude Code with one command. A self-hosted setup needs ANTHROPIC_API_KEY and BETTER_AUTH_SECRET; its first boot downloads about 2.2 GB of embedding weights. That download is the main setup constraint on a local deployment.
What it helps with
- search a connected knowledge brain
- measure documentation coverage with an exam
- surface gaps after zero-result searches
- carry agent state into a later session
- submit reviewed knowledge corrections as proposals
Example prompts for the agent
- Search the connected mozg brain for the Expo setup and include the source.
- List the available brains and give me a short brief for each.
- Hand the current working context to the next session with
brain_handoff.
How to install mozg
Platform CLI: remote server
claude mcp add --transport http mozg https://mozg.sh/mcpPlatform CLI: remote server
codex mcp add mozg --url https://mozg.sh/mcpConfig file
{
"mcpServers": {
"mozg": {
"url": "https://mozg.sh/mcp"
}
}
}Config file
{
"servers": {
"mozg": {
"type": "http",
"url": "https://mozg.sh/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http mozg https://mozg.sh/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mozg
How do I install mozg in Claude Code?
Run claude mcp add --transport http mozg https://mozg.sh/mcp.
What does mozg do?
It exposes scored knowledge brains to agents through MCP, retrieves relevant notes, and records coverage gaps. It can also pass working state between sessions.
What does a self-hosted mozg setup require?
Set ANTHROPIC_API_KEY and BETTER_AUTH_SECRET. The first boot downloads about 2.2 GB of embedding weights.
