# Komplyt Zero

> Komplyt Zero is an open-source MCP server for knowledge and memory. Shared memory graph for AI agents: decisions kept with reasons, unused ones fade. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, API
- **Repository:** https://github.com/komplyzen/komplyt-zero/tree/HEAD/src
- **MCP Registry name:** io.github.Komplyzen/komplyt-zero
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-15

## About

Agents lose the reasoning behind a decision when a session ends, and each client keeps its own notes. Komplyt Zero stores decisions, problems and approaches as typed nodes in a graph, each with the reason attached, so any MCP client can later find them by meaning rather than keyword.

Ranking blends 0.7 times cosine similarity with 0.3 times a decay score, then follows graph edges for up to three hops to bring related nodes along. Each new session in a project multiplies every node's score by 0.85, so unused knowledge drops down the ranking, while updated nodes climb back toward a 0.85 ceiling. Nothing is deleted.

The README shows tools such as kg_session_start, kg_node_create and kg_query. You can use a hosted service in Frankfurt, free for one person, or self-host with SurrealDB and either Ollama or Cohere embeddings. The core is Apache-2.0, while the team features are source-available under PolyForm Noncommercial, so the repository as a whole is not OSI open source.

## Features

- **Typed decision nodes:** Stores decisions, problems and approaches together with the reason behind them.
- **Semantic recall:** Finds nodes by meaning using embeddings, then follows linked nodes.
- **Decay ranking:** Unused knowledge fades in ranking each session without being deleted.
- **Hosted or self-hosted:** Use the EU-hosted service or run SurrealDB and the server yourself.
- **Choice of embeddings:** Self-hosted installs use Ollama or Cohere, one per install.
- **Docker quickstart:** A compose file starts SurrealDB, Ollama and the server for one machine.

## Good for

- Remember why an architecture choice was made
- Share project context between Claude Code and ChatGPT
- Stop a team from re-deciding settled questions
- Track open problems alongside related decisions

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http komplyt-zero https://kg.kompl.yt/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://kg.kompl.yt/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "komplyt-zero": {
      "url": "https://kg.kompl.yt/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "komplyt-zero": {
      "type": "http",
      "url": "https://kg.kompl.yt/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "komplyt-zero": {
      "serverUrl": "https://kg.kompl.yt/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://kg.kompl.yt/mcp
```

Enter a Name (for example "Komplyt Zero"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "komplyt-zero": {
      "type": "http",
      "url": "https://kg.kompl.yt/mcp"
    }
  }
}
```

## Tools

- `kg_session_start`: Starts a session in a project, optionally creating it.
- `kg_node_create`: Records a typed node such as a decision, with tags and content.
- `kg_query`: Searches the graph by meaning and returns linked nodes.

## FAQ

### Is the hosted service free?

The README says it is free for one person, with data stored in Frankfurt.

### What database does self-hosting need?

SurrealDB, reachable over WebSocket, plus an embedding provider.

### Does it delete old knowledge?

No. Decay lowers ranking only, and faded nodes still appear for close matches.

### Is the whole repo open source?

No. The core is Apache-2.0 but team features and SurrealDB have other licences.

### Is Komplyt Zero free?

Yes. Komplyt Zero is open source, so you can use and self-host it for free.

### How do I add Komplyt Zero to Claude Code?

Run this command in your terminal: claude mcp add --transport http komplyt-zero https://kg.kompl.yt/mcp

### What are the best alternatives to Komplyt Zero?

The closest alternatives to Komplyt Zero are Total Agent Memory, Kognite, Ainative Zerodb Memory MCP, Tzivia-AI and Kagura Memory Cloud.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Total Agent Memory](https://ai-powered.com/mcp/total-agent-memory): Total Agent Memory is an open-source MCP server for knowledge and memory.
- [Kognite](https://ai-powered.com/mcp/kognite): Kognite is a freemium MCP server for knowledge and memory.
- [Ainative Zerodb Memory MCP](https://ai-powered.com/mcp/ainative-zerodb-memory-mcp): Ainative Zerodb Memory MCP is an MCP server for knowledge and memory.
- [Tzivia-AI](https://ai-powered.com/mcp/tzivia-ai): Tzivia-AI is an MCP server for knowledge and memory.
- [Kagura Memory Cloud](https://ai-powered.com/mcp/kagura-memory-cloud): Kagura Memory Cloud is an open-source MCP server for knowledge and memory.
- [Neuromcp](https://ai-powered.com/mcp/neuromcp): Neuromcp is an open-source MCP server for knowledge and memory.
- [GrayMatter](https://ai-powered.com/mcp/graymatter-2): GrayMatter is an open-source MCP server for knowledge and memory.
- [MaxGraph](https://ai-powered.com/mcp/maxgraph): MaxGraph is an MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/komplyt-zero
