Skip to content
MCP server

Assertion Memory

Shared memory of decisions and reasoning for Claude Code, Cursor and Codex teams

Install
Pricing
Freemium
Platforms
CLI, API
Runs
Remotely
Version
1.0.0
Listing updated
today

About Assertion Memory

Assertion Memory is a freemium MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://memory.assertion-ai.com/memory/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "assertion": {
      "url": "https://memory.assertion-ai.com/memory/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Freemium

Free to start; paid plans not detailed

Prices change. Check assertion-ai.com before you buy.

Assertion Memory 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 to Assertion Memory

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools