# Dreamd

> Dreamd is an open-source MCP server for knowledge and memory. Local memory store for coding agents that traces every lesson back to its source. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/botzrdev/dreamd
- **MCP Registry name:** io.github.botzrDev/dreamd
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Most agent memory is a black box. This server keeps it as plain files inside your repository: episodes are lines in a JSONL file, lessons live in a Markdown file, and each lesson cites the events it was promoted from. A periodic dream cycle clusters episodes by action and writes a lesson, then commits it to git.

When an agent keeps repeating bad advice, a blame command lists the stored memories behind a recall with ids, timestamps and scores. A forget command removes the event and the lesson state naming it, with a dry run and an optional receipt file. A doctor check recomputes the provenance ledger's Merkle root and flags orphaned or corrupt edges.

The README is candid about limits: it does not detect or block poisoned writes, the ledger and receipts are unsigned, and the source harness is asserted by the caller. Recall is lexical, ranked by BM25 and salience; vector recall is not shipped. With an API key the dream cycle can use an LLM under a 10 cent per-cycle cap, otherwise it writes a deterministic lesson.

## Features

- **Blame for memories:** Lists the stored memories behind a recall, with ids, source and score.
- **Forget with receipt:** Removes an event and its lesson state, with dry run and receipt file.
- **Provenance ledger:** Records which event fed which lesson and checks it with a Merkle root.
- **Git-reviewed lessons:** Each dream cycle commits its output so lessons can be reviewed and reverted.
- **Plain-file storage:** JSONL and Markdown that cat, grep and git log can read.

## Good for

- Find which stored memory caused a wrong agent answer
- Review what agents learned in a pull request
- Remove a poisoned or mistaken memory with proof
- Share one memory store across Claude Code, Cursor and Cline

## Install

### Claude Code (Terminal)

```sh
claude mcp add dreamd -- npx -y dreamd-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "dreamd": {
      "command": "npx",
      "args": [
        "-y",
        "dreamd-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dreamd": {
      "command": "npx",
      "args": [
        "-y",
        "dreamd-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "dreamd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "dreamd-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dreamd": {
      "command": "npx",
      "args": [
        "-y",
        "dreamd-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dreamd": {
      "command": "npx",
      "args": [
        "-y",
        "dreamd-mcp"
      ]
    }
  }
}
```

## Tools

- `search_nodes`: Search stored memory and recall prior context, with the source harness on every hit.
- `append_node`: Write an episode to memory.

## FAQ

### How do I install it?

Run npx -y dreamd-mcp setup to scaffold the .agent folder and wire your harness, then your harness spawns npx -y dreamd-mcp over stdio.

### Does it block poisoned memory?

No. The README says it does not detect or block poisoned writes; it makes bad memory traceable and removable.

### Which clients work?

Claude Code, Cursor, Cline and other MCP-aware harnesses.

### Does it need a network?

Not by default. Without an API key the dream cycle makes no network call.

### Is Dreamd free?

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

### How do I add Dreamd to Claude Code?

Run this command in your terminal: claude mcp add dreamd -- npx -y dreamd-mcp

### What are the best alternatives to Dreamd?

The closest alternatives to Dreamd are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/dreamd
