Skip to content
MCP server

Vayl

Agent memory that replaces outdated facts, keeps history and can hold changes for approval

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.11.0
Listing updated
3 days ago

About Vayl

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

Facts are written so a new value supersedes the old one and a removal retracts it, so a retired fact is never returned as current, while the history stays queryable. Ambiguous inputs are flagged rather than guessed, and high-stakes changes can wait for human approval.

It targets agents where a wrong stored fact causes harm, such as medication lists or account status. The docs demo shows a warfarin to apixaban change held until confirm_change. Locally it runs over stdio with one SQLite file, and a team server is available. It needs an OpenAI key or a local Ollama model, and the license is Apache-2.0.

The docs mention encryption at rest, a tamper-evident audit chain and GDPR building blocks.

Install

Run in a terminal

claude mcp add vayl --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- uvx vayl-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vayl": {
      "command": "uvx",
      "args": [
        "vayl-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vayl": {
      "command": "uvx",
      "args": [
        "vayl-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "vayl": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "vayl-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "vayl": {
      "command": "uvx",
      "args": [
        "vayl-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "vayl": {
      "command": "uvx",
      "args": [
        "vayl-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Configuration

  • OPENAI_API_KEYOpenAI key for extraction and embeddings. Leave unset to use a local Ollama model.
  • VAYL_DBAbsolute path of the SQLite memory database.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

remember
Stores a fact and reconciles it against existing ones.
recall
Answers from current memory.
confirm_change
Approves a held change.
pending_changes
Lists changes awaiting approval.
check_before_act
Checks memory before an action.

What it does

Reconciles on write
New values supersede old ones.
History
Ask what was true before.
Approval hold
Pending changes wait for confirmation.
Audit chain
Signed, tamper-evident log.
Local first
SQLite file with optional team server.

Good for

  • Keep a medication list current
  • Track account status for a support agent
  • Audit how a stored fact changed
  • Gate risky memory changes on approval

Pricing

Open source

Apache-2.0, free to self-host

Prices change. Check vayl.gitbook.io before you buy.

Vayl FAQ

What license?

Apache-2.0.

Which models does it need?

An OpenAI key, or a local Ollama model.

Where is data stored?

In a SQLite file at VAYL_DB.

Which tools exist?

Includes remember, recall, confirm_change, pending_changes and check_before_act.

Is Vayl free?

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

How do I add Vayl to Claude Code?

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

What are the best alternatives to Vayl?

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

Alternatives to Vayl

  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