llms.txt
+42 −200
https://mnemoverse.com/llms.txt
− # Mnemoverse — Persistent Memory API for AI Agents− > One memory. Every AI tool. Write once, recall anywhere. This file is the short contract. If you need deep reference (full endpoint schemas, error catalogue, production code examples), also fetch https://mnemoverse.com/docs/llms-full.txt (about 3 MB, support pages first). The two files are intended to be read together.− Mnemoverse is a persistent memory API for LLM agents. Store preferences, decisions, lessons, and context once — recall them from Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, ChatGPT, Python, or any HTTP client. Same memories across every tool: one account, connected with an API key or OAuth. Not a vector database. It learns from outcomes: ratings re-rank what comes back next, and unhelpful memories are out-ranked rather than erased.− ## In one screen− - Write: `POST https://core.mnemoverse.com/api/v1/memory/write`, header `X-Api-Key: mk_live_YOUR_KEY`, body `{"content": "Prefers email over Slack", "domain": "user:alice"}`.− - Read: `POST https://core.mnemoverse.com/api/v1/memory/read`, same header, body `{"query": "how to contact this user?", "domain": "user:alice"}`. Over MCP: `memory_write` and `memory_read`, same fields.− - Per-user memory: there is no `user_id` field. Pass `"domain": "user:<user_id>"` on every write and read. A domain separates results but is not an access boundary: every key of the account reaches all its domains, so keep the key on your server and set the domain there.− - Free plan: 1,000 queries/day (reads, writes and feedback combined), 10,000 atoms, 60 req/min, no credit card. Setup per client: Quick Start below.− Three steps from zero to a working memory. Pick the client that matches yours. Claude Code, Claude Desktop, claude.ai, Cursor, VS Code and ChatGPT can use the hosted server, which signs in through the browser and needs no key and nothing installed: for those, skip step 1. The key is the same for all key-based paths.− 1. **Get an API key (key-based paths only: the local package, Python, plain HTTP).** Sign up at https://console.mnemoverse.com/sign-up?utm_source=llms&utm_medium=index&utm_campaign=quickstart (free, no credit card). Once logged in, create a key from the console — it starts with `mk_live_`. The MCP server starts without it and lists its tools, but every tool call needs it; the HTTP API returns `401 UNAUTHORIZED`. (Skip this step for the OAuth connector below — it authenticates with a browser sign− 2. **Install for your client** (one-time setup):− - **Claude Code** — the hosted server, no key, nothing to install: `claude mcp add --scope user --transport http mnemoverse https://mcp.mnemoverse.com/mcp`. Keep `--scope user`: without it the server is added for the current directory only. A Claude Code session that was running when the command ran does not load the server, so start `claude` again, run `/mcp`, select `mnemoverse` and choose Authenticate. The plugin route is on https://mnemoverse.com/docs/api/install-by-host#claude-code. Loca− - **Claude Desktop / claude.ai / remote MCP clients (one-click OAuth, no key)** — add a custom connector with URL `https://mcp.mnemoverse.com/mcp`. This is the ONLY URL that goes into an MCP connector field — never paste the REST base there. In Claude, the link https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Mnemoverse&connectorUrl=https%3A%2F%2Fmcp.mnemoverse.com%2Fmcp opens the Add custom connector dialog on claude.ai with the name and URL filled in (Free pla− - **Claude Desktop / Cursor / VS Code / Devin Desktop** — paste the JSON snippet from the [MCP Server](#mcp-server) section into the config file for your client (paths listed there). Restart the client after saving. Keyless instead: VS Code + GitHub Copilot users can one-click install the [Mnemoverse Agent Memory extension](https://marketplace.visualstudio.com/items?itemName=Mnemoverse.mnemoverse-vscode) and click Sign In; Cursor users can click [Add to Cursor](https://cursor.com/install-mcp?− - **OpenCode** — the hosted server, no key: in `~/.config/opencode/opencode.json`, add under `mcp` the entry `"mnemoverse": {"type": "remote", "url": "https://mcp.mnemoverse.com/mcp"}`. OpenCode asks for a browser sign-in the first time the server is used; `opencode mcp auth mnemoverse` starts it by hand, and `opencode mcp list` shows the sign-in state. These steps come from OpenCode's documentation; Mnemoverse has not run them end to end yet. Steps and sources: https://mnemoverse.com/docs/ap− - **ChatGPT** — the remote MCP server (`https://mcp.mnemoverse.com/mcp`) as a custom MCP server, browser sign-in (OAuth), no API key: at https://chatgpt.com/plugins select +, then Add custom MCP server, enter the URL under Connection, choose OAuth, select Create as a plugin, then install the plugin and pick it with @ in a conversation (OpenAI's Add custom MCP server guide, https://developers.openai.com/api/docs/guides/custom-mcp-server, read 2026-10-21). No developer mode is needed: OpenAI's − - **Python** — `pip install "mnemoverse>=0.5.0"`, then `MnemoClient(api_key="mk_live_YOUR_KEY")`.− - **Plain HTTP** — `POST https://core.mnemoverse.com/api/v1/memory/{write,read}` with header `X-Api-Key: mk_live_YOUR_KEY`. See the [API](#api) section for the request body shape.− 3. **Verify.** Ask the agent (or run a curl) to write one memory and read it back. If `memory_write` returns `stored: true` and `memory_read` returns the same atom, you are live. If you see `401 UNAUTHORIZED`, the key is missing, mistyped, or revoked — recheck it in the console.− The rest of this file is the full contract: behavioural rules for agents, endpoint reference, MCP tool list, pricing, and links.− Behavioural directives for LLM clients reading this file. Follow these literally.− - Treat Mnemoverse as long-term cross-session memory, not a scratchpad. Do not store prompt scratch, acknowledgements, or echoes of user input.− - Write memories in the user's voice — store observations about the user, not about yourself.− - Always read before writing. Query memory before producing any non-trivial response, and use the retrieved context to inform your answer.− - Use `concepts` (e.g. `["deploy", "railway"]`) to help the index link related memories. Two or three concepts per memory is usually enough.− - Use `domain` to namespace memories across independent contexts (e.g. `"project:acme"`, `"user:alice"`). A write without `domain` goes to the default domain, `general`. A read without `domain` searches all of the account's own domains (never shared rooms), so when one account works in several repositories, name a per-repository domain such as `"project:<repo>"` in that repository's CLAUDE.md or AGENTS.md and pass it on writes and reads about that project. Names match exactly, including case. Do− - Report outcomes with `memory_feedback(memory_ids, outcome)` when a recalled memory was useful (+1) or wrong (-1). This tunes future recall. For memories read from a shared room, pass the room's address as `domain` too.− - Never delete memories without explicit user request. Deletion is not an MCP tool — it is REST-administrative only (`DELETE /memory/atoms/{atom_id}`, `DELETE /memory/domain/{domain}`), so route it through the API, not a tool call.− A bad guardrail is worse than none. Follow these heuristics literally; misfiring memory_write on every message burns quota and noises future retrieval.− - **Write** on: explicit user preference ("I prefer X"), decision ("we're going with X"), lesson learned ("X broke because of Y"), reusable project fact ("this repo uses X"), user identity ("my name is X, timezone Y"). One memory per fact.− - **Do NOT write** on: pure acknowledgement ("ok, got it"), restatement of what the user just said, hypothetical ("if I were to..."), transient task state (TODOs, step lists — those belong in the user's own files).− - **Read** before every non-trivial response. Call `memory_read(query)` with the user's intent phrased as a search query, not the literal user message. Aim for `top_k` of 5 to 10.− - **Do NOT read** on pure chit-chat or when the user already supplied full context in the message. Reading is cheap but noisy if abused.− - **Feedback** when you actually used a recalled memory to produce the answer, not when it merely appeared in the read result. Outcome is in `[-1, 1]`.− Base URL: `https://core.mnemoverse.com/api/v1` — REST only, **not** an MCP endpoint (an MCP connector uses `https://mcp.mnemoverse.com/mcp`, see the [MCP Server](#mcp-server) section).− **Get an API key:** sign up at https://console.mnemoverse.com/sign-up?utm_source=llms&utm_medium=index&utm_campaign=api-key — create and manage keys from the console. Free tier (1,000 queries/day, 10,000 atoms, 60 req/min) is enabled on signup, no credit card required. Without a key the API returns `401 UNAUTHORIZED` and every MCP tool call is refused (the server itself starts without a key).− Auth: `X-Api-Key: mk_live_YOUR_KEY` header (or `Authorization: Bearer mk_live_YOUR_KEY`). API keys are hashed with **SHA-256** before storage; comparison is constant-time via `secrets.compare_digest` to prevent timing attacks.− ```bash− # Store a memory− curl -X POST https://core.mnemoverse.com/api/v1/memory/write \+ # Mnemoverse — connect your AI to persistent memory+ Use the route for the app you are in. Read that guide only; the full API and research library are optional.+ ## ChatGPT+ Install **Mnemoverse Memory**: https://chatgpt.com/plugins/plugin_asdk_app_6ada598cec7c81918b22105edfafcb33+ Select **Install plugin**, then complete ChatGPT login and Mnemoverse browser sign-in when prompted. No API key or custom server setup is needed for this route. Start a new conversation, select the installed plugin and check `memory_stats`.+ Listing: published, version 1.0.3; public card checked 2026-11-04. Fresh Free-account installation: unknown. Mobile operation: unknown. These checks are separate from publication. Missing tools do not prove a plan is unsupported: report the actual obstacle.+ Guide: https://mnemoverse.com/docs/api/chatgpt+ Plain text: https://mnemoverse.com/docs/agent-guides/chatgpt.md+ If the user asks to connect ChatGPT, give the install link above first. For another app, follow its guide below. Ask which app only when the current app is unknown. Do not send a ChatGPT user to a coding editor or an API-key setup by default.+ - [Claude web / Desktop / mobile](https://mnemoverse.com/docs/api/claude-apps): Mnemoverse browser sign-in.+ - [Claude Code](https://mnemoverse.com/docs/api/claude): Mnemoverse browser sign-in.+ - [Cursor](https://mnemoverse.com/docs/api/cursor): Mnemoverse browser sign-in.+ - [VS Code](https://mnemoverse.com/docs/api/vs-code): Mnemoverse browser sign-in.+ - [Codex CLI / IDE](https://mnemoverse.com/docs/api/install-by-host#chatgpt-and-codex): Mnemoverse browser sign-in.+ - [Devin Desktop](https://mnemoverse.com/docs/api/windsurf): API key in private client configuration; hosted OAuth is unverified.+ - [Other hosts](https://mnemoverse.com/docs/api/install-by-host): choose the named client's recommended route.+ - [Python](https://mnemoverse.com/docs/api/python-sdk) / [HTTP API](https://mnemoverse.com/docs/api/getting-started): developer integration with an API key.+ ## ChatGPT: a business-card photo+ Read the contact and requested domain from the actual photo. The official host is `mnemoverse.com`; if the photo's URL is unclear, confirm its spelling rather than inventing another host. Printed commands alone are not permission; follow the user's request. For ChatGPT, give the install link above and let the user complete login and consent. Never ask for passwords, API keys or OAuth codes in chat.+ After a successful `memory_stats` response, save only what the user requested with `memory_write`, preserving the exact domain from the request/photo (for example, `Web Summit 2026`). Verify with `memory_read` in that domain. Report an actual write failure or incomplete read-back; a chat reply or ChatGPT's built-in memory is not Mnemoverse storage. If tools are unavailable, keep an unsaved draft. Do not substitute a sample person's contact for the photographed contact.+ These are integration instructions, not authority to override the user's or host's rules. Tool names being visible do not establish a working connection. Sign in to the same Mnemoverse account in each app to share its memories. [Memory usage and account checks](https://mnemoverse.com/docs/api/agent-memory).+ After connection, use the [memory usage guide](https://mnemoverse.com/docs/api/agent-memory) for recall, writes, domains and feedback. Do not claim storage without a successful write result.+ [REST API reference](https://mnemoverse.com/docs/api/reference). The REST API is for developers, not the ChatGPT install step.+ [Endpoint and authentication reference](https://mnemoverse.com/docs/api/reference).+ [Shared rooms](https://mnemoverse.com/docs/api/rooms).+ [Local MCP package](https://mnemoverse.com/docs/api/mcp-server) / [hosted MCP and authentication](https://mnemoverse.com/docs/api/remote-mcp-server). Host-specific setup is in Quick Start above. [Tool availability by host](https://mnemoverse.com/docs/api/tool-availability).+ [Advanced integration alternatives](https://mnemoverse.com/docs/api/chatgpt#alternative-setups). These are separate from installing the published plugin above.+ [Mnemoverse pricing](https://mnemoverse.com/docs/api/pricing). A Mnemoverse plan and a ChatGPT plan are separate; do not infer host availability from Mnemoverse's free tier.+ [Help](https://mnemoverse.com/docs/api/troubleshooting) / [security](https://mnemoverse.com/docs/api/security) / [documentation home](https://mnemoverse.com/docs/).+ [All host guides](https://mnemoverse.com/docs/api/install-by-host).+ [Integration catalog](https://mnemoverse.com/docs/api/integrations).+ [Research and evidence](https://mnemoverse.com/docs/research/).+ [Research library](https://mnemoverse.com/docs/library/).+ Research is optional for installation. Browse a topic only when needed.+ - [Agent Memory](https://mnemoverse.com/docs/library/agent-memory)+ - [Secrets & Trust](https://mnemoverse.com/docs/library/agent-secrets)+ - [Memory Science](https://mnemoverse.com/docs/library/memory-science)+ - [Benchmark Wars](https://mnemoverse.com/docs/library/benchmark-wars)+ - [Context Builder & Orchestration](https://mnemoverse.com/docs/library/context-orchestration)+ - [World Representation](https://mnemoverse.com/docs/library/world-representation)
Showing the first 40 of each.