mcpField
W

wontopos

Local
wontopos.comMemory & Knowledge
Visit website

About wontopos

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

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "com-wontopos": {
      "command": "npx",
      "args": [
        "-y",
        "wontopos-mcp"
      ],
      "env": {
        "WONTOPOS_API_KEY": "<WONTOPOS_API_KEY>",
        "WONTOPOS_USER_ID": "<WONTOPOS_USER_ID>",
        "WONTOPOS_MODEL": "<WONTOPOS_MODEL>",
        "WONTOPOS_VERIFY": "<WONTOPOS_VERIFY>",
        "WONTOPOS_MAX_IMAGES": "<WONTOPOS_MAX_IMAGES>",
        "WONTOPOS_BASE_URL": "<WONTOPOS_BASE_URL>",
        "WONTOPOS_TIMEOUT_MS": "<WONTOPOS_TIMEOUT_MS>",
        "WONTOPOS_READ_ONLY": "<WONTOPOS_READ_ONLY>",
        "WONTOPOS_ALLOW_STORE_OVERRIDE": "<WONTOPOS_ALLOW_STORE_OVERRIDE>",
        "WONTOPOS_HTTP_PORT": "<WONTOPOS_HTTP_PORT>",
        "WONTOPOS_HTTP_TOKEN": "<WONTOPOS_HTTP_TOKEN>",
        "WONTOPOS_HTTP_HOST": "<WONTOPOS_HTTP_HOST>",
        "WONTOPOS_HTTP_ALLOWED_HOSTS": "<WONTOPOS_HTTP_ALLOWED_HOSTS>"
      }
    }
  }
}
Run commandnpx -y wontopos-mcp
Environment variables to set
WONTOPOS_API_KEYSecretWontopos API key (wos-live-...). Create one in the console at wontopos.com.
WONTOPOS_USER_IDDefault store for every tool call (default: "default").
WONTOPOS_MODELEngine 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_VERIFYDefault 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_IMAGESDefault 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_URLA different API host. Leave unset for the default.
WONTOPOS_TIMEOUT_MSPer-request timeout in ms (default 20000). A stalled API then fails in-band instead of hanging the host.
WONTOPOS_READ_ONLYSet to 1 for read-only mode: recall/search/list_memories/engram/stats/revisions/view_image/usage only, no write or delete tools.
WONTOPOS_ALLOW_STORE_OVERRIDESet to 1 to let tools take a user_id argument (multi-store). Default: every call is pinned to WONTOPOS_USER_ID.
WONTOPOS_HTTP_PORTServe over HTTP on this port instead of stdio, for hosts that cannot spawn a local process. Requires WONTOPOS_HTTP_TOKEN.
WONTOPOS_HTTP_TOKENSecretBearer token every HTTP request must carry. Required whenever WONTOPOS_HTTP_PORT is set.
WONTOPOS_HTTP_HOSTInterface to bind in HTTP mode. Default 127.0.0.1 (this machine only).
WONTOPOS_HTTP_ALLOWED_HOSTSComma-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.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmwontopos-mcp1.0.26

Tools

13

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
limitanyNoLong-term memories, 5-20 (default 10). Out of range is refused.
querystringYesWhat to remember about, phrased like the user's need.
context_limitanyNoConversation rows around the best match, 0-20 (default 10); 0 for memories only.

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.