# Context Vault

> Context Vault is a freemium MCP server for security. Persistent, local-first memory for agents, stored as plain markdown. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** macOS, Linux, CLI, API
- **Website:** https://context-vault.com
- **Repository:** https://github.com/fellanh/context-vault
- **MCP Registry name:** io.github.fellanH/context-vault
- **Categories:** security, knowledge and memory
- **Listing updated:** 2026-11-14

## About

Context Vault keeps what an agent learns as markdown files on your machine and recalls them in later sessions. The README claims a first save and recall in about five minutes with Claude Code: install the binary with a curl script, run context-vault setup to add it to Claude Code, Claude Desktop, Cursor, Windsurf, Cline and Roo Code, restart, and ask the agent to save to your vault.

Entries are organised by kind such as insight, decision, pattern or reference, and scoped by bucket tags. Search is full-text and semantic, with a search model of about 90 MB downloaded on first start. Extra tools ingest a URL or a local project, compile a topic into a snapshot and save a session summary.

A hosted vault is available through api.context-vault.com/mcp. The free hosted plan has 25,000 entries, 250 MB and 5,000 requests a day, and the page says paid upgrades are currently unavailable.

## Features

- **Plain markdown files:** Entries are readable, editable files on your machine.
- **Full-text and semantic search:** get_context searches both ways, with an embedding model downloaded on first run.
- **Kinds and buckets:** Organises entries by kind and scopes them with bucket tags.
- **URL and project ingest:** Saves page text or registers a local project.
- **Snapshots and session notes:** Compiles a topic brief and saves session summaries.
- **One-command setup:** context-vault setup configures supported clients.

## Good for

- Recall why a technical decision was made in an earlier session
- Keep project conventions across coding agents
- Save a page's readable text for later
- Hand a topic brief to a new session

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http context-vault https://api.context-vault.com/mcp
```

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

```sh
https://api.context-vault.com/mcp
```

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

```json
{
  "mcpServers": {
    "context-vault": {
      "url": "https://api.context-vault.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "context-vault": {
      "type": "http",
      "url": "https://api.context-vault.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "context-vault": {
      "serverUrl": "https://api.context-vault.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "context-vault": {
      "type": "http",
      "url": "https://api.context-vault.com/mcp"
    }
  }
}
```

## Tools

- `save_context`: Save an entry, or update one by id.
- `get_context`: Search the vault, full-text and semantic.
- `recall`: Light hints from a raw signal such as a prompt or error.
- `list_context`: Browse entries by kind, tags or date.
- `delete_context`: Remove an entry by id.
- `ingest_url`: Fetch a page and save its readable text.
- `ingest_project`: Scan a local project and register it.
- `create_snapshot`: Compile entries on a topic into one brief.
- `session_end`: Save a session summary and its discoveries.
- `context_status`: Vault health: paths, counts, issues.
- `list_buckets`: List buckets.

## FAQ

### Is it free?

The local vault is free with no account. The hosted free plan has 25,000 entries and 250 MB.

### Which clients does setup configure?

Claude Code, Claude Desktop, Cursor, Windsurf, Cline and Roo Code.

### Is Pro available?

The pricing page lists $9 a month as proposed and says paid upgrades are currently unavailable.

### What happens at the hosted limit?

New writes pause and existing entries stay available, with no automatic overage billing.

### Is Context Vault free?

Context Vault has a free plan, with paid plans for more usage or features.

### How do I add Context Vault to Claude Code?

Run this command in your terminal: claude mcp add --transport http context-vault https://api.context-vault.com/mcp

### What are the best alternatives to Context Vault?

The closest alternatives to Context Vault are REA, Codebase Memory, XERJ, Claude Code Ultimate Guide and Nautilus Compass Memory.

## 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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [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.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.

---
Source: https://ai-powered.com/mcp/context-vault-2
