Skip to content

Remote MCP Server (one-click sign-in)

The remote MCP server is a hosted endpoint that gives any MCP client persistent Mnemoverse memory after a one-click OAuth sign-in — no API key to copy or paste. The client connects to https://mcp.mnemoverse.com/mcp, opens a browser consent screen once, and stores the token itself.

TL;DR: point your tool at https://mcp.mnemoverse.com/mcp, sign in when the browser opens, done. You get four memory tools — read, write, stats, and feedback — tied to your Mnemoverse account.

New to Mnemoverse? Create a free account at console.mnemoverse.com first — no credit card. The sign-in below grants the token; there's no API key to paste.

Status

The endpoint and its OAuth discovery chain are live and serving today — you can add the server manually in any compliant client right now. One-click listings in client directories (Anthropic Connectors, the ChatGPT connector catalog) are rolling out; until a listing appears, use the manual "add custom connector" steps below.

Remote connector vs. local package

There are two ways to give a tool Mnemoverse memory. They reach the same memory — pick by how you want to authenticate.

Remote connector (this page)Local package (@mnemoverse/mcp-memory-server)
AuthOAuth sign-in — no key to pasteAPI key (mk_live_…) in the config
RunsHosted by MnemoverseLocally via npx
Endpointhttps://mcp.mnemoverse.com/mcpstdio (spawned process)
Tools4 (read · stats · write · feedback)6 (adds delete · delete_domain)
Best forQuick start, no secret managementScripts, CI, or when you need the delete tools

If you want destructive operations (memory_delete, memory_delete_domain), use the local package or the REST API — the remote connector deliberately omits them so a one-click sign-in can never wipe memory.

Connect

Same endpoint everywhere — https://mcp.mnemoverse.com/mcp. The first tool call (or first connect) opens your browser to sign in. Full per-client walkthroughs, including the consent screen and verify steps, are in Agent Setup → One-click OAuth Connect.

  • Claude Codeclaude mcp add --transport http mnemoverse https://mcp.mnemoverse.com/mcp
  • Claude Desktop — Settings → Connectors → Add custom connector → paste the URL.
  • Cursor — add to .cursor/mcp.json (project root): { "mcpServers": { "mnemoverse": { "url": "https://mcp.mnemoverse.com/mcp" } } }
  • Windsurf — add to ~/.codeium/windsurf/mcp_config.json (global): { "mcpServers": { "mnemoverse": { "url": "https://mcp.mnemoverse.com/mcp" } } }
  • VS Code — add to .vscode/mcp.json: { "servers": { "mnemoverse": { "type": "http", "url": "https://mcp.mnemoverse.com/mcp" } } } — the "type": "http" is required, or VS Code falls back to stdio.
  • ChatGPT — Settings → Connectors → Browse → Mnemoverse Memory → Connect. This connector is rolling out; until the listing appears, the one-click OAuth path isn't available in ChatGPT — use the Custom GPT + API-key setup (a different integration) as a temporary alternative.

How sign-in works

The remote server is an OAuth 2.1 + PKCE resource server; your tool is the OAuth client.

  1. The client connects to https://mcp.mnemoverse.com/mcp over streamable HTTP (the MCP HTTP transport — any current MCP client supports it) and gets a 401 pointing at its protected-resource metadata.
  2. It follows the discovery chain to the authorization server, https://auth.mnemoverse.com/api/auth, and opens the consent screen in your browser.
  3. You sign in to your Mnemoverse account and grant the scopes: openid, profile, email, memory:read, memory:write, offline_access.
  4. The client stores the access + refresh tokens and sends the access token on every request. No API key is ever entered.

You manage your account and revoke access at console.mnemoverse.com. A connector granted only memory:read can recall but not write.

Tools

The remote connector exposes four tools (see the API reference for full parameters):

  • memory_read — recall memories by a natural-language query.
  • memory_stats — report counts, domains, and association stats for your memory.
  • memory_write — store a new memory.
  • memory_feedback — mark which recalled memories were useful, so ranking improves over time.

memory_delete and memory_delete_domain are not exposed here by design — use the local package or REST API for those.

Troubleshooting

  • 401 / "invalid token" after a while — the access token expired. Ask your tool any question that uses memory and it refreshes automatically. If that fails, remove the server from your client's config, restart the client, and re-add the URL to run sign-in again.
  • A GET to the endpoint returns 404 — expected. The endpoint is POST-only (streamable HTTP); a browser visit isn't how you connect.
  • VS Code ignores the server — make sure the entry has "type": "http"; without it VS Code tries to launch it as a local stdio process.
  • Cursor or Windsurf ignores the server — check the config file path: .cursor/mcp.json (project root) for Cursor, ~/.codeium/windsurf/mcp_config.json (global) for Windsurf. Restart the app after editing.
  • No "Mnemoverse" in the connector directory yet — listings are rolling out; add it manually with the steps above in the meantime.
  • Writes are rejected — the connector was granted read-only (memory:read); reconnect and grant memory:write.