Wontopos MCP Server

com.wontopos/mcpv1.0.24

Wontopos (WOS) long-term memory (beta) - one memory across Claude Code, Cursor, and your agents.

Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active4d ago

Install Wontopos MCP server

claude mcp add wontopos -e WONTOPOS_API_KEY='<wontopos-api-key>' -e WONTOPOS_HTTP_TOKEN='<wontopos-http-token>' -- npx -y wontopos-mcp

{
  "mcpServers": {
    "wontopos": {
      "command": "npx",
      "args": [
        "-y",
        "wontopos-mcp"
      ],
      "env": {
        "WONTOPOS_API_KEY": "<wontopos-api-key>",
        "WONTOPOS_HTTP_TOKEN": "<wontopos-http-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "wontopos": {
      "command": "npx",
      "args": [
        "-y",
        "wontopos-mcp"
      ],
      "env": {
        "WONTOPOS_API_KEY": "<wontopos-api-key>",
        "WONTOPOS_HTTP_TOKEN": "<wontopos-http-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "wontopos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wontopos-mcp"
      ],
      "env": {
        "WONTOPOS_API_KEY": "<wontopos-api-key>",
        "WONTOPOS_HTTP_TOKEN": "<wontopos-http-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "wontopos": {
      "command": "npx",
      "args": [
        "-y",
        "wontopos-mcp"
      ],
      "env": {
        "WONTOPOS_API_KEY": "<wontopos-api-key>",
        "WONTOPOS_HTTP_TOKEN": "<wontopos-http-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
WONTOPOS_API_KEY	yes	yes	Wontopos API key (wos-live-...). Create one in the console at wontopos.com.
WONTOPOS_USER_ID	—	—	Default store for every tool call (default: "default").
WONTOPOS_MODEL	—	—	Engine to read with: tablet-2 (default — same token price as tablet-1, and the one that serves photos and re-ask), tablet-1, scroll-1, or scroll-1.2.
WONTOPOS_VERIFY	—	—	Default re-ask passes for search, 0-3 (default 0). Each pass is another engine call and is billed for what it delivers; the agent can raise it per call.
WONTOPOS_MAX_IMAGES	—	—	Default photo results per search, 0-5 (default 0). Zero because these rows ride on every search; the view_image tool fetches the one picture that is wanted.
WONTOPOS_BASE_URL	—	—	A different API host. Leave unset for the default.
WONTOPOS_TIMEOUT_MS	—	—	Per-request timeout in ms (default 20000). A stalled API then fails in-band instead of hanging the host.
WONTOPOS_READ_ONLY	—	—	Set to 1 for read-only mode: recall/search/list_memories/engram/stats/revisions only, no write or delete tools.
WONTOPOS_ALLOW_STORE_OVERRIDE	—	—	Set to 1 to let tools take a user_id argument (multi-store). Default: every call is pinned to WONTOPOS_USER_ID.
WONTOPOS_HTTP_PORT	—	—	Serve over HTTP on this port instead of stdio, for hosts that cannot spawn a local process. Requires WONTOPOS_HTTP_TOKEN.
WONTOPOS_HTTP_TOKEN	—	yes	Bearer token every HTTP request must carry. Required whenever WONTOPOS_HTTP_PORT is set.
WONTOPOS_HTTP_HOST	—	—	Interface to bind in HTTP mode. Default 127.0.0.1 (this machine only).
WONTOPOS_HTTP_ALLOWED_HOSTS	—	—	Comma-separated Host header values to accept in HTTP mode, for a tunnel that forwards its own public name. Loopback and the bind address are always accepted; anything else is refused 403.

Freshness

Active — last maintenance signal 4d ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-05 · 4d ago · official registry · v1.0.24

FAQ

›How do I install the Wontopos MCP server in Claude Code?

Run: claude mcp add wontopos -e WONTOPOS_API_KEY='<wontopos-api-key>' -e WONTOPOS_HTTP_TOKEN='<wontopos-http-token>' -- npx -y wontopos-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Wontopos require an API key?

Yes. It expects WONTOPOS_API_KEY, WONTOPOS_HTTP_TOKEN, of which 2 are secrets.

›Can I use Wontopos as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Wontopos in the official MCP registry?

Yes, as com.wontopos/mcp.