Wontopos MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add mcp -e 'WONTOPOS_API_KEY=<WONTOPOS_API_KEY>' -- npx -y wontopos-mcp

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wontopos-mcp"
      ],
      "env": {
        "WONTOPOS_API_KEY": "<WONTOPOS_API_KEY>"
      }
    }
  }
}

[mcp_servers.mcp]
command = "npx"
args = ["-y", "wontopos-mcp"]
env = { WONTOPOS_API_KEY = "<WONTOPOS_API_KEY>" }

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wontopos-mcp"
      ],
      "env": {
        "WONTOPOS_API_KEY": "<WONTOPOS_API_KEY>"
      }
    }
  }
}

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

Put your own value in place of <WONTOPOS_API_KEY> (Wontopos API key (wos-live-...). Create one in the console at wontopos.com). The author’s registry entry marks it as required.

Optional settings from the registry entry, left out of the block above: 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/view_image/usage 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 (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).