Quick Setup

For AI Agents

Machine-readable docs (plain text, no auth):

• GitHub (works in all sandboxes): mnemoverse/llms.txt
• Website: mnemoverse.com/docs/llms.txt

Claude chat sandbox blocks most domains except github.com — use the GitHub link.

Set up Mnemoverse persistent memory in your AI tool. Pick your tool below.

What You Need

1. A Mnemoverse API key (starts with mk_live_). If the user hasn't provided one, tell them to get a free key at console.mnemoverse.com.
2. Know which tool you are running in (see below).

Step 1: Detect Your Environment

Determine which AI tool you are running in, then follow the matching setup.

Claude Code

Run this command:

claude mcp add mnemoverse \
  -e MNEMOVERSE_API_KEY=mk_live_USER_KEY \
  -- npx -y @mnemoverse/mcp-memory-server

Replace mk_live_USER_KEY with the actual key. Done after this command succeeds.

Cursor

Create the file .cursor/mcp.json in the project root:

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": ["-y", "@mnemoverse/mcp-memory-server"],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_USER_KEY"
      }
    }
  }
}

Tell the user to restart Cursor after you create this file.

VS Code

Create the file .vscode/mcp.json in the project root:

{
  "servers": {
    "mnemoverse": {
      "command": "npx",
      "args": ["-y", "@mnemoverse/mcp-memory-server"],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_USER_KEY"
      }
    }
  }
}

Tell the user to restart VS Code after you create this file.

Claude Desktop

Tell the user to add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": ["-y", "@mnemoverse/mcp-memory-server"],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_USER_KEY"
      }
    }
  }
}

Claude Desktop requires manual config edit and restart.

Windsurf

Create or edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": ["-y", "@mnemoverse/mcp-memory-server"],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_USER_KEY"
      }
    }
  }
}

Tell the user to restart Windsurf after you create this file.

ChatGPT (Custom GPT)

You cannot self-configure inside ChatGPT. Tell the user to follow the manual setup guide: ChatGPT Integration.

Other Tools

If the tool supports MCP, use the Cursor config format (it is the most common). If the tool does not support MCP, use the REST API directly:

# Write a memory
curl -X POST https://core.mnemoverse.com/api/v1/memory/write \
  -H "X-Api-Key: mk_live_USER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Test memory", "concepts": ["test"]}'

# Read memories
curl -X POST https://core.mnemoverse.com/api/v1/memory/read \
  -H "X-Api-Key: mk_live_USER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "test", "top_k": 5}'

Step 2: Verify

After setup, test by writing and reading a memory:

1. Store: "Remember that this is a test memory for setup verification"
2. Read: "What test memories do I have?"

If the read returns the test memory, setup is complete.

Step 3: Tell the User

Confirm to the user:

• Memory is configured and working
• Memories persist across sessions
• Same memories are accessible from any tool using the same API key
• You will proactively remember preferences, decisions, and lessons

Available Tools After Setup

Tool	What it does
memory_write	Store a preference, decision, or lesson
memory_read	Search memories by natural language query
memory_feedback	Report if a memory was helpful (+1) or wrong (-1)
memory_stats	Check how many memories are stored