Skip to content
MCP server

Attestor

Self-hosted memory for agent teams. Bi-temporal replay, deterministic retrieval, audit…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
4.0.0
Listing updated
4 days ago

About Attestor

Attestor is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Self-hosted memory for agent teams. Bi-temporal replay, deterministic retrieval, audit log.

Install

Run in a terminal

claude mcp add attestor --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- uvx attestor

Add to claude_desktop_config.json

{
  "mcpServers": {
    "attestor": {
      "command": "uvx",
      "args": [
        "attestor"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "attestor": {
      "command": "uvx",
      "args": [
        "attestor"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "attestor": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "attestor"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "attestor": {
      "command": "uvx",
      "args": [
        "attestor"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "attestor": {
      "command": "uvx",
      "args": [
        "attestor"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Configuration

  • ATTESTOR_PATHDirectory containing attestor's config.toml. Defaults to ~/.attestor.
  • ATTESTOR_DISABLE_LOCAL_EMBEDSet to 1 to skip the local Ollama embedder probe (e.g., on hosts without Ollama). Defaults to unset (Ollama is the default embedder).
  • OPENAI_API_KEYOpenAI API key (used for the OpenAI text-embedding-3-large fallback embedder when Ollama is unavailable).
  • OPENROUTER_API_KEYOpenRouter API key (used for the federated LLM extraction / consolidation paths and for the LongMemEval benchmark runner).

Pricing

Open source

Attestor FAQ

Is Attestor free?

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

How do I add Attestor to Claude Code?

Run this command in your terminal: claude mcp add attestor --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- uvx attestor

What are the best alternatives to Attestor?

The closest alternatives to Attestor are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

Alternatives to Attestor

  1. 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
  2. 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
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity