
Memstate AI - Git for Agent Memory
@memstate-ai
About Memstate AI - Git for Agent Memory
Git for agent memory. Memstate gives AI agents versioned, structured memory with automatic conflict detection, full version history, and up to 80% fewer tokens than vector-based alternatives. Extracts facts from text and markdown into structured keypaths, with 84.4% accuracy on t
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"memstate": {
"command": "npx",
"args": [
"-y",
"@memstate/mcp"
],
"env": {
"MEMSTATE_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Tools
7Store markdown, task summaries, decisions. Server extracts keypaths and detects conflicts automatically. **Use for most writes.**
Set a single keypath to a short value (e.g. `config.port = 8080`). Not for prose.
Browse all memories for a project or subtree. **Use at the start of every task.**
Semantic search by meaning when you don't know the exact keypath.
See how a piece of knowledge changed over time — full version chain.
Soft-delete a keypath. Creates a tombstone; full history is preserved.
Soft-delete an entire project and all its memories.
Overview
What is Memstate AI - Git for Agent Memory?
Memstate AI - Git for Agent Memory is a hosted MCP server that provides versioned memory for AI agents. It stores facts, detects conflicts when information changes, and tracks decision history over time, using structured key-value storage instead of embedding-based semantic search.
How to use Memstate AI - Git for Agent Memory?
Get an API key from memstate.ai/dashboard, then configure your MCP client with the npx command npx -y @memstate/mcp and the MEMSTATE_API_KEY environment variable. No Docker or database is required. Supported clients include Claude Desktop, Claude Code, Cursor, Cline, Windsurf, Kilo Code, and Roo Code.
Key features of Memstate AI - Git for Agent Memory
- Structured, versioned key-value storage for agent memories
- Built-in conflict detection when new facts contradict old ones
- Deterministic recall — returns exact stored values, not approximations
- Constant O(1) token cost regardless of total memory size
- Full version history with soft-delete and tombstone preservation
- Hierarchical dot-notation keypaths for precise browsing
Use cases of Memstate AI - Git for Agent Memory
- Track architectural decisions and specifications across multiple agent sessions
- Detect and resolve contradictions when requirements or configurations change
- Maintain reliable cross-session context without dumping full history into prompts
- Audit how project knowledge evolved over time using full version chains
FAQ from Memstate AI - Git for Agent Memory
How does Memstate AI compare to RAG-based memory systems?
Memstate uses structured key-value storage with versioning rather than embedding-based semantic search. This gives deterministic recall, built-in conflict detection, and constant token cost, whereas RAG systems return approximate matches, cannot distinguish current vs outdated facts, and have O(n) token growth.
Do I need to run any infrastructure?
No. Memstate is a hosted SaaS — only an API key and the npx command are required. There is no Docker, database, or self-hosted server to maintain.
How are memories organized and retrieved?
Memories are stored in hierarchical dot-notation keypaths (e.g., project.myapp.database.schema). Keypaths are auto-prefixed with a project ID. The agent browses summaries first and drills into specific subtrees only when needed, keeping token usage constant.
What tools does the MCP server expose?
The server provides seven core tools: memstate_remember (for markdown summaries and decisions), memstate_set (for short scalar values), memstate_get, memstate_search, memstate_history, memstate_delete, and memstate_delete_project.
What
More Memory & Knowledge MCP servers
Semantic Scholar MCP Server
YUZongminA FastMCP server implementation for the Semantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.
RAG Documentation MCP Server
hannesrudolphAn MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.
minutes
silversteinEvery meeting, every idea, every voice note — searchable by your AI. Open-source, privacy-first conversation memory layer.
Basic Memory
basicmachines-coAI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN
Mcp Knowledge Graph
shanehollomanMCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development
Comments