com.wontopos/mcp

claude mcp add com-wontopos-mcp -e 'WONTOPOS_API_KEY=<your wontopos_api_key>' -e 'WONTOPOS_USER_ID=<WONTOPOS_USER_ID>' -e 'WONTOPOS_MODEL=<WONTOPOS_MODEL>' -e 'WONTOPOS_VERIFY=<WONTOPOS_VERIFY>' -e 'WONTOPOS_MAX_IMAGES=<WONTOPOS_MAX_IMAGES>' -e 'WONTOPOS_BASE_URL=<WONTOPOS_BASE_URL>' -e 'WONTOPOS_TIMEOUT_MS=<WONTOPOS_TIMEOUT_MS>' -e 'WONTOPOS_READ_ONLY=<WONTOPOS_READ_ONLY>' -e 'WONTOPOS_ALLOW_STORE_OVERRIDE=<WONTOPOS_ALLOW_STORE_OVERRIDE>' -e 'WONTOPOS_HTTP_PORT=<WONTOPOS_HTTP_PORT>' -e 'WONTOPOS_HTTP_TOKEN=<your wontopos_http_token>' -e 'WONTOPOS_HTTP_HOST=<WONTOPOS_HTTP_HOST>' -e 'WONTOPOS_HTTP_ALLOWED_HOSTS=<WONTOPOS_HTTP_ALLOWED_HOSTS>' -- npx -y wontopos-mcp@1.0.26

{
    "mcpServers": {
        "com-wontopos-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "wontopos-mcp@1.0.26"
            ],
            "env": {
                "WONTOPOS_API_KEY": "<your 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": "<your wontopos_http_token>",
                "WONTOPOS_HTTP_HOST": "<WONTOPOS_HTTP_HOST>",
                "WONTOPOS_HTTP_ALLOWED_HOSTS": "<WONTOPOS_HTTP_ALLOWED_HOSTS>"
            }
        }
    }
}

متغيرات البيئة

• WONTOPOS_API_KEY إلزامي سري 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/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.