The Memory Problem in AI Agents
Modern LLMs are incredibly powerful, but they have a fundamental limitation: they forget everything between conversations. Every time you start a new session with an AI agent, it's like talking to someone with amnesia.
This means:
- Chatbots can't remember user preferences
- Research assistants lose their context mid-project
- Autonomous agents restart their reasoning from scratch
- Long-running tasks get progressively more expensive as you re-inject context
The solution? Persistent, searchable memory that lives outside the LLM's context window.
Introducing Agent Memory MCP
Agent Memory MCP is an open-source MCP server that provides persistent key-value memory for AI agents. It's like giving your agent its own brain — one that remembers everything without blowing up your token budget.
Core Features
- Persistent key-value storage — Store any data with string keys
- TTL-based expiry — Set items to auto-expire after a configurable time
- Full-text search — Find memories by content, not just by key
- Namespace isolation — Separate memories by agent, user, or session
- Zero dependencies — Lightweight, runs anywhere Python runs
- MCP-native — Works with any MCP-compatible client out of the box
Why Memory Changes Everything
Before Persistent Memory
User: "I prefer responses in Spanish."
Agent: "Okay, noted." [responds in Spanish]
--- Next conversation ---
User: "Tell me about quantum computing."
Agent: [responds in English] ❌ Forgot the preference
After Agent Memory MCP
User: "I prefer responses in Spanish."
Agent: "Okay, noted."
→ Stores: memory["language_preference"] = "Spanish"
--- Next conversation ---
Agent on startup:
→ Retrieves: memory["language_preference"] = "Spanish"
→ Applies preference automatically ✅
Quick Start
# Clone the repo
git clone https://github.com/Rumblingb/agent-memory-mcp.git
cd agent-memory-mcp
# Install
pip install -r requirements.txt
# Run
python server.py
Add it to your MCP client config:
{
"mcpServers": {
"agent-memory": {
"command": "python",
"args": ["-m", "agent_memory_mcp"]
}
}
}
Using Memory in Your Agent
# Store a memory
await session.call_tool("store_memory", {
"key": "user_123_preferences",
"value": {"language": "Spanish", "tone": "professional", "timezone": "UTC-5"},
"ttl": 604800 # Auto-expire after 7 days
})
# Search memories
results = await session.call_tool("search_memories", {
"query": "Spanish language preference",
"limit": 5
})
# Get a specific memory
prefs = await session.call_tool("get_memory", {
"key": "user_123_preferences"
})
# List all recent memories
recent = await session.call_tool("list_memories", {
"namespace": "user_123",
"limit": 20
})
Real-World Applications
1. Customer Support Bots
Remember customer history, past issues, preferences, and resolved tickets. Each conversation picks up where the last one left off.
2. Research Assistants
Store research findings, article summaries, and source links as the agent works through a project. No more losing context after API limits.
3. Personal AI Assistants
Learn user preferences over time — communication style, frequently used tools, common workflows. The agent gets smarter the more you use it.
4. Multi-Agent Systems
Shared memory across agents means Agent A can store findings that Agent B can discover and build upon. True collaborative intelligence.
Memory Management Best Practices
Use TTLs wisely. Set short TTLs (hours) for session data, medium TTLs (days) for user preferences, and long TTLs (months) for learned knowledge.
Namespace by entity. Use namespaces like user:{id}, session:{id}, or project:{name} to keep memories organized and prevent collisions.
Search, don't iterate. When you need information, use search_memories instead of listing everything. It's faster and cheaper.
Clean up expired data. The TTL system automatically deletes expired entries, but you can manually trigger cleanup with cleanup_expired.
Pro Features
The open-source version handles unlimited storage locally. The Pro version ($19/month) adds:
- Cloud sync across agents
- Advanced semantic search
- Priority support
- Custom retention policies
👉 Subscribe to Agent Memory MCP Pro — $19/month
Get Started
Agent Memory MCP is free and open-source. Give your agents the gift of remembering.
🔗 GitHub: https://github.com/Rumblingb/agent-memory-mcp
💳 Agent Memory MCP Pro: https://buy.stripe.com/cNifZj0qXesc6DKcfh1oI0y
Built with ❤️ by the AgentPay team. Memory isn't just storage — it's identity.
Top comments (0)