About nexus-memory-mcp
nexus-memory-mcp provides persistent semantic memory for AI agents that need context across sessions. It combines linked memories, session continuity, and activatable domain knowledge packs.
Key features
- 01Search memories semantically
- 02Link memories in knowledge graphs
- 03Save and restore session state
- 04Activate Intelligence Packs
- 05View memory statistics and context
Use cases
- 01Restore prior work in a new session
- 02Find preferences or decisions by meaning
- 03Load domain knowledge for an agent
MCP support
It is an MCP server exposing tools for memory storage and retrieval, linking, session continuity, and Intelligence Packs.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y nexus-memory-mcpNEXUS_API_KEYSecretAPI key for Memory Nexus (get at bot-marketplace-production.up.railway.app or via /v1/trial/start)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
10Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| content | string | Yes | What to remember (be descriptive) |
| context | string | No | Category: "preferences", "architecture", "decisions", "patterns", etc. |
| metadata | string | No | Optional JSON string with additional data |
| importance | number | No | 0.0 to 1.0 - higher = more important |
Details
From the project READMENexus Memory MCP
Persistent semantic memory for AI agents. Remember everything, recall by meaning, grow smarter over time.
The only memory system with pre-built Intelligence Packs (domain expertise you can activate instantly).
Install
One command. Works with Claude Code, Cursor, Windsurf, or any MCP-compatible client.
npx -y nexus-memory-mcp
Claude Code / Cursor / Windsurf
Add to your .mcp.json:
{
"mcpServers": {
"nexus-memory": {
"command": "npx",
"args": ["-y", "nexus-memory-mcp"],
"env": {
"NEXUS_API_KEY": "mnx_your_api_key_here"
}
}
}
}
Get an API Key
Free trial - 7 days, 1,000 calls, no credit card:
curl -X POST https://memory-api-production-ce4d.up.railway.app/v1/trial/start \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]"}'
Or purchase at the Nexus Marketplace:
| Tier | Price | Agents | Intelligence Packs | Storage | Daily Calls |
|---|---|---|---|---|---|
| Trial | Free | 1 | 1 | 10MB | 1,000 total |
| Solo | $19/mo | 1 | 3 | 500MB | 10,000 |
| Crew | $49/mo | 5 | 10 | 2GB | 50,000 |
| Fleet | $149/mo | 25 | 50 | 10GB | 200,000 |
Tools
Core Memory
| Tool | Description |
|---|---|
remember | Store a memory with context, importance, and metadata |
recall | Semantic search across all memories (by meaning, not keywords) |
connect | Create relationships between memories (build knowledge graphs) |
forget | Remove a memory |
stats | Memory statistics |
context | Session context summary (preferences, decisions, patterns) |
Agent Self-Continuity
| Tool | Description |
|---|---|
awaken | Restore identity from previous sessions (call at session start) |
hibernate | Save session state for next awakening (call at session end) |
Intelligence Packs
| Tool | Description |
|---|---|
list_hats | Browse available Intelligence Packs |
wear_hat | Activate a pack (imports expert knowledge into your memory) |
How It Works
Remember stores memories with semantic embeddings. Recall finds them by meaning.
Session 1: remember("Diana prefers bold solutions over phased approaches")
Session 47: recall("how does Diana like things done?")
-> "Diana prefers bold solutions over phased approaches" (92% match)
Intelligence Packs give your agent instant domain expertise:
list_hats() -> DevOps Expert (103 memories), TCM Specialist (200+ memories), ...
wear_hat("devops-expert")
recall("how to set up zero-downtime deploys?")
-> Expert knowledge from 103 curated DevOps memories
Awaken/Hibernate gives your agent identity continuity:
// Start of session
awaken() -> "I remember. Session 47. I was refactoring the auth module."
// End of session
hibernate({ working_on: "auth refactor", learnings: "JWT refresh tokens need..." })
Architecture
This MCP server is a thin client. All intelligence lives on our servers:
Your Agent <-> nexus-memory-mcp <-> Nexus Memory API (Railway)
(thin MCP client) (semantic engine, knowledge graphs,
pattern learning, Intelligence Packs)
Your data is isolated per API key. Multi-tenant, encrypted at rest.
Environment Variables
| Variable | Required | Description |
|---|---|---|
NEXUS_API_KEY | Yes | Your API key (starts with mnx_) |
NEXUS_API_URL | No | Custom API URL (default: production) |
What Makes This Different
| Feature | Nexus Memory | Mem0 | claude-mem | Others |
|---|---|---|---|---|
| Semantic search | Yes | Yes | Yes | Varies |
| Knowledge graphs | Yes | No | No | No |
| Pattern learning | Yes | No | No | No |
| Intelligence Packs | Yes | No | No | No |
| Awaken/Hibernate | Yes | No | No | No |
| Bot commerce | Yes | No | No | No |
| MCP native | Yes | Yes (pip) | Yes (hooks) | Varies |
License
MIT
Built by
Mobius Collective - Building the intelligence marketplace for the bot economy.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.