# Wontopos

> Wontopos is a freemium MCP server for knowledge and memory. One long-term memory store shared across Claude Code, Cursor and your agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $5 a month
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Website:** https://wontopos.com
- **MCP Registry name:** com.wontopos/mcp
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-21

## About

Wontopos supplies the memory behind this server, so what one tool learns in a session can be recalled in another. The registry entry marks it beta. Its stdio package runs locally with a Wontopos API key, and an optional HTTP mode with a bearer token serves hosts that cannot spawn a process.

Configuration is unusually detailed. A user ID pins every call to one store unless multi-store override is enabled, read-only mode registers only reading tools, and settings choose the engine, re-ask passes for search (0 to 3) and how many photo results come back per search, with a view_image tool for fetching one picture. Engines are tablet-2 (default), tablet-1, scroll-1, scroll-1.2 and scroll-2.

The company describes Tablet as re-ask and image memory, Scroll as long-conversation recall (it quotes 77.6% on BEAM 1M) and Book as learning from past mistakes. It says memory is never used to train models.

## Features

- **Shared memory:** One store reachable from several clients and agents.
- **Read-only mode:** Register only reading tools for safer use.
- **Re-ask search:** Optional extra passes return memories not already given.
- **Photo memory:** Stores images and finds them from a sentence.
- **Separate stores:** Pin each person or agent to its own store.
- **HTTP mode:** Serve over HTTP with a bearer token when stdio is unavailable.

## Good for

- Carry project context from Claude Code to Cursor
- Give an agent memory of earlier sessions
- Keep separate memory per user
- Fetch a stored photo by description

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env WONTOPOS_API_KEY='<WONTOPOS_API_KEY>' --env WONTOPOS_HTTP_TOKEN='<WONTOPOS_HTTP_TOKEN>' --env WONTOPOS_ROUTER_KEY='<WONTOPOS_ROUTER_KEY>' --env WONTOPOS_SKILL_KEY='<WONTOPOS_SKILL_KEY>' -- npx -y wontopos-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wontopos-mcp"
      ],
      "env": {
        "WONTOPOS_API_KEY": "<WONTOPOS_API_KEY>",
        "WONTOPOS_HTTP_TOKEN": "<WONTOPOS_HTTP_TOKEN>",
        "WONTOPOS_ROUTER_KEY": "<WONTOPOS_ROUTER_KEY>",
        "WONTOPOS_SKILL_KEY": "<WONTOPOS_SKILL_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wontopos-mcp"
      ],
      "env": {
        "WONTOPOS_API_KEY": "<WONTOPOS_API_KEY>",
        "WONTOPOS_HTTP_TOKEN": "<WONTOPOS_HTTP_TOKEN>",
        "WONTOPOS_ROUTER_KEY": "<WONTOPOS_ROUTER_KEY>",
        "WONTOPOS_SKILL_KEY": "<WONTOPOS_SKILL_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wontopos-mcp"
      ],
      "env": {
        "WONTOPOS_API_KEY": "<WONTOPOS_API_KEY>",
        "WONTOPOS_HTTP_TOKEN": "<WONTOPOS_HTTP_TOKEN>",
        "WONTOPOS_ROUTER_KEY": "<WONTOPOS_ROUTER_KEY>",
        "WONTOPOS_SKILL_KEY": "<WONTOPOS_SKILL_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wontopos-mcp"
      ],
      "env": {
        "WONTOPOS_API_KEY": "<WONTOPOS_API_KEY>",
        "WONTOPOS_HTTP_TOKEN": "<WONTOPOS_HTTP_TOKEN>",
        "WONTOPOS_ROUTER_KEY": "<WONTOPOS_ROUTER_KEY>",
        "WONTOPOS_SKILL_KEY": "<WONTOPOS_SKILL_KEY>"
      }
    }
  }
}
```

## Tools

- `search`: Searches stored memories, with optional re-ask passes.
- `view_image`: Fetches one stored picture.

## FAQ

### Is Wontopos beta?

The registry description labels it beta.

### What do I need to run Wontopos?

A Wontopos API key set in WONTOPOS_API_KEY.

### Is there a free tier?

Free gives $5 credit after a short survey, then pay as you go.

### Is my data used for training?

The pricing page says memories are never used to train AI models.

### How do I add Wontopos to Claude Code?

Run this command in your terminal: claude mcp add mcp --env WONTOPOS_API_KEY='<WONTOPOS_API_KEY>' --env WONTOPOS_HTTP_TOKEN='<WONTOPOS_HTTP_TOKEN>' --env WONTOPOS_ROUTER_KEY='<WONTOPOS_ROUTER_KEY>' --env WONTOPOS_SKILL_KEY='<WONTOPOS_SKILL_KEY>' -- npx -y wontopos-mcp

### What are the best alternatives to Wontopos?

The closest alternatives to Wontopos are Mnemoverse Memory, Uteke, VelesDB Memory, Polypack Memory and Memento.

## Where this comes from

- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Mnemoverse Memory](https://ai-powered.com/mcp/mnemoverse-memory): Mnemoverse Memory is a freemium MCP server for knowledge and memory.
- [Uteke](https://ai-powered.com/mcp/uteke): Uteke is an open-source MCP server for knowledge and memory.
- [VelesDB Memory](https://ai-powered.com/mcp/velesdb-memory): VelesDB Memory is an MCP server for knowledge and memory.
- [Polypack Memory](https://ai-powered.com/mcp/polypack-memory): Polypack Memory is an MCP server for knowledge and memory.
- [Memento](https://ai-powered.com/mcp/memento-2): Memento is an open-source MCP server for knowledge and memory.
- [persistent-memory](https://ai-powered.com/mcp/persistent-memory): persistent-memory is an open-source MCP server for knowledge and memory.
- [Neuromcp](https://ai-powered.com/mcp/neuromcp): Neuromcp is an open-source MCP server for knowledge and memory.
- [CogniCore](https://ai-powered.com/mcp/cognicore): CogniCore is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/wontopos
