Vayl
Agent memory that replaces outdated facts, keeps history and can hold changes for approval
- 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-mcpAdd 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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP 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

Nautilus Compass Memory
MCP serverLocal-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

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
MedXpert 图书馆连接器(通用版)
MCP serverLocal MCP server that searches and answers questions over your own Markdown wiki
Runs locally- 4 tools
- Open source
- Knowledge and memory