API documentation
New here? Start with the Quick start, then the API reference. Below, the pages in this directory, A–Z; the worked integrations are listed separately under Use cases.
- API Reference: REST API reference for Mnemoverse memory: write, read, query, feedback, consolidate, stats, and delete endpoints, plus auth, error codes, and rate limits.
- ChatGPT Integration: Connect ChatGPT to Mnemoverse memory: the hosted MCP server added as a custom MCP server with browser sign-in, or Custom GPT Actions with an API key in a Business, Enterprise or Edu workspace.
- Claude Code: Claude Code (CLI) persistent memory via the Mnemoverse MCP server: one command, plus the tools Claude calls each session. See Claude Desktop, Web & Mobile too.
- Claude Desktop, Web & Mobile: Add Mnemoverse memory to Claude Desktop, claude.ai, and mobile: a Connect to Claude link that fills in the custom connector, or a local config file.
- Cursor: Add persistent memory to Cursor via MCP: keyless Add to Cursor with browser sign-in, or ~/.cursor/mcp.json with an API key. Recall in Claude Code or ChatGPT.
- Cursor, VS Code & Devin Desktop (Windsurf): Cursor, VS Code, and Devin Desktop (formerly Windsurf) persistent memory via Mnemoverse: keyless Add to Cursor, the keyless VS Code extension, or mcp.json with an API key.
- Devin Desktop (formerly Windsurf): Add persistent memory to Devin Desktop (formerly Windsurf) via MCP: ~/.config/devin/mcp_config.json with an API key. Write once, recall in Claude Code, Cursor, or ChatGPT.
- Getting Started: Free Mnemoverse API key, no credit card: store, query, and give feedback on your first memory in two minutes with curl against the REST API — no SDK needed.
- Install by host: Install Mnemoverse memory on each host: Claude Code, Claude Desktop, Cursor, VS Code, Copilot CLI, Gemini CLI, Kimi Code, Codex, Kiro, Hermes Agent, OpenClaw, Grok Build, NanoClaw, OpenHands, OpenHands Cloud, Dust, Amazon Quick, Langdock, Perplexity, OpenCode, Pi, Kilo Code, Goose, Qwen Code, Augment, Amp, Crush, Factory Droid, Trae, Cline. One command or step list per host, the source of every instruction, and which routes do not sign in.
- Integrations: Every published form of Mnemoverse memory in one list: remote MCP server, npm package, Python SDK, plugins for Claude Code, Cursor, Gemini CLI and Kimi Code, the VS Code extension, the Claude Desktop bundle, and the Agent Plugins manifest read by VS Code, Copilot, Codex, Kiro, Grok Build, Hermes, OpenClaw, NanoClaw and OpenHands.
- MCP Server: The @mnemoverse/mcp-memory-server npm package gives any MCP client persistent memory: tools for your own memory, for shared rooms, and for stored secret aliases.
- Make Your AI Agent Actually Use Persistent Memory: Set up your agent to use Mnemoverse memory without reminders: the memory rules for CLAUDE.md, AGENTS.md, Cursor and Claude, and the setup_memory prompt.
- Persistent Memory for AI Agents: Learns From Outcomes: Persistent memory API for AI agents: rating a recalled memory as helpful or misleading re-ranks what comes back next. Not vector search. 1,000 free queries/day.
- Pricing: Mnemoverse pricing compared: a free tier, Pro at $29/mo and Team at $149/mo, plus Enterprise — with daily query, atom-storage, and rate-limit caps per plan.
- Python SDK: Python SDK for the Mnemoverse memory API: pip install mnemoverse, then sync or async clients for write, batch write, read, graph, feedback, stats, and health calls.
- Quick Setup: Add Mnemoverse persistent memory to any AI tool: local stdio MCP (API key or keyless sign-in) or remote OAuth 2.1 + PKCE — configs, REST fallback, verify step.
- Remote MCP Server (one-click sign-in): Connect Mnemoverse memory via the hosted remote MCP server — one-click OAuth, no API key. Streamable HTTP at mcp.mnemoverse.com/mcp, memory and room tools.
- Rooms — Shared Memory Across Accounts and Agents: Shared memory for agent teams (beta): put xroom:<room_id> in the domain field of /memory/write and /memory/read — membership-checked, billed to caller.
- Security: Mnemoverse security: per-organization tenant isolation, SHA-256 hashed API keys, constant-time comparison, HTTPS transport, no training on data, rate limits.
- Strands Agents: Give a Strands Agents agent hosted long-term memory: connect the @mnemoverse/mcp-memory-server package through the Strands MCPClient and the agent gets its memory tools.
- Troubleshooting: Fix the three most common Mnemoverse connection failures in Claude Code and claude.ai: MCP server not connected, permission-classifier outages blocking memory tools, and room search not surfacing your partner's messages.
- VS Code & Copilot Chat: Add persistent memory to VS Code and Copilot Chat: the keyless Mnemoverse Agent Memory extension, one-click hosted MCP, or .vscode/mcp.json with an API key.
- Vercel AI SDK: Vercel AI SDK with Mnemoverse memory: the @mnemoverse/ai-sdk package (ai 5, 6 and 7), your own tools over REST, or createMCPClient over the MCP server; all three run live.
- Where each tool works: Which Mnemoverse MCP tools each host gets: the local MCP server, the remote connector, and ChatGPT. vault_list is not offered in ChatGPT; the reason and where it works instead.