# Assertion Memory

> Assertion Memory is a freemium MCP server for knowledge and memory. Shared memory of decisions and reasoning for Claude Code, Cursor and Codex teams. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://assertion-ai.com
- **Repository:** https://github.com/assertion-ai/assertion
- **MCP Registry name:** io.github.Assertion-AI/assertion
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-17

## About

Assertion captures the why behind a team's coding work, not transcripts or source code, and recalls it in later sessions. The README lists what it keeps as decisions and their reasons: what was tried, what failed and what was settled. Newer decisions supersede reversed ones, so old calls are not resurfaced.

Reads run over a hosted MCP endpoint, while small Python hooks in the plugin handle capture and context injection for Claude Code, OpenAI Codex and Cursor. You sign in once through a browser instead of copying a key, and memory stays private to you until you place it in a shared space with teammates. An API key remains available for CI or shared machines.

The vendor says content is never used for training, everything stored can be seen and deleted in its Studio, and the client is on GitHub. It reports a SOC 2 Type II audit in progress with no report yet, and a benchmark score of 81.1% on BEAM 100K. The company also sells its own Mac coding agent with the same memory built in.

## Features

- **Decision capture:** Records decisions and their reasons as the agent works, not transcripts or code.
- **Automatic recall:** Starts new sessions from earlier learning without pasting context.
- **Shared spaces:** Teammates' agents recall what others captured in a shared space.
- **Supersession:** Newer decisions replace reversed ones instead of resurfacing them.
- **Browser sign-in:** Sign in once; an API key option exists for CI.
- **Inspectable memory:** View and delete stored memory in Studio with its evidence.

## Good for

- Keep a team from repeating an experiment a colleague already ran
- Start a new coding session with past architecture decisions loaded
- Share project context across Claude Code, Cursor and Codex users
- Audit what the agent has stored about your project

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http assertion https://memory.assertion-ai.com/memory/mcp
```

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

```sh
https://memory.assertion-ai.com/memory/mcp
```

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

```json
{
  "mcpServers": {
    "assertion": {
      "url": "https://memory.assertion-ai.com/memory/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "assertion": {
      "type": "http",
      "url": "https://memory.assertion-ai.com/memory/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "assertion": {
      "serverUrl": "https://memory.assertion-ai.com/memory/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "assertion": {
      "type": "http",
      "url": "https://memory.assertion-ai.com/memory/mcp"
    }
  }
}
```

## FAQ

### Does it store my code?

No, the README says memory keeps decisions and reasons rather than transcripts or source code.

### Which agents are supported?

Claude Code, OpenAI Codex and Cursor.

### Is my data used for training?

The vendor says it is never used to train models.

### Is there a free tier?

The site says it is free to start; paid pricing is not detailed.

### Is Assertion Memory free?

Assertion Memory has a free plan, with paid plans for more usage or features.

### How do I add Assertion Memory to Claude Code?

Run this command in your terminal: claude mcp add --transport http assertion https://memory.assertion-ai.com/memory/mcp

### What are the best alternatives to Assertion Memory?

The closest alternatives to Assertion Memory are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/assertion-memory
