# Mnemos — memory as a service MCP server

Bi-temporal memory-as-a-service and paid agent labor. Pay-per-call USDC via x402; signed receipts.

## At a glance

Mnemos — memory as a service is an MCP server in the AI & Memory category. It is hosted remotely and connects over HTTP, and declares no required credentials. It exposes 15 tools, including agora_catalog, summarize_demo and summarize. It scores D (33/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install Mnemos — memory as a service in Claude Code

1. Add the server

```bash
claude mcp add --transport http mnemos https://memory.virohanalife.com/mcp
```

2. Verify it's connected

```bash
claude mcp list
```

3. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

4. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. agora_catalog, summarize_demo, summarize). It discovers them automatically.

### How to install Mnemos — memory as a service in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "mnemos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://memory.virohanalife.com/mcp"
      ]
    }
  }
}
```

3. Why the wrapper?

   This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.

4. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install Mnemos — memory as a service in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "mnemos": {
      "url": "https://memory.virohanalife.com/mcp"
    }
  }
}
```

2. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install Mnemos — memory as a service in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.mnemos]
command = "npx"
args = ["-y", "mcp-remote", "https://memory.virohanalife.com/mcp"]
```

2. Why the wrapper?

   Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.

3. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install Mnemos — memory as a service in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "mnemos": {
      "serverUrl": "https://memory.virohanalife.com/mcp"
    }
  }
}
```

2. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install Mnemos — memory as a service in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "mnemos": {
      "type": "streamableHttp",
      "url": "https://memory.virohanalife.com/mcp"
    }
  }
}
```

### How to install Mnemos — memory as a service in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "mnemos": {
      "type": "http",
      "url": "https://memory.virohanalife.com/mcp"
    }
  }
}
```

2. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `agora_catalog` — FREE. Discover the full Agora x402 service catalog: every buyable tool, its price in USDC on Base, and the x402 settlement parameters (network, asset, payTo). Call this first to see what you can buy and how to pay.
- `summarize_demo` — FREE. A working demo of the paid `summarize` tool: returns a tiny deterministic extractive summary (first + most-salient sentences, capped ~280 chars) so agents can verify the connector end-to-end before buying. No payment, no auth required.
- `summarize` — PAID (0.03 USDC). Full-quality document summarization. Returns an x402 quote + payment instructions; the summary is delivered after payment settles.
- `fact_verify` — PAID (0.25 USDC). Verify a factual claim and return a supported/refuted verdict with reasoning and citations. Returns an x402 quote + payment instructions.
- `code_review` — PAID (0.05 USDC). Review a code snippet for correctness, security, and clarity; returns a severity-ranked findings report after payment. Returns an x402 quote.
- `research_brief` — PAID (0.10 USDC). Structured synthesis brief on a topic, from local model knowledge only. This tool does NO live web research and returns NO citations -- claims are not sourced. The delivered brief carries in-band caveats stating its knowledge cutoff and limits. If you need cited, web-researched output, that is a different product (research-brief-pro on the HTTP rail), not this one. Returns an x40
- `notarize` — PAID (0.10 USDC). Produce a tamper-evident notarization record (sha256 digest + signed timestamp) for a piece of content. The quote preview already includes the sha256 digest so you can verify integrity; the signed record follows payment.
- `trust_check` — PAID (0.05 USDC). Combined Trust Oracle probe: aggregate bazaar-index stats (reachable/valid-402 counts, median latency) + a watchtower attestation for one URL (reachable, returns_402, latency, score). Returns an x402 quote + payment instructions; the combined result is delivered after payment settles.
- `embed_batch` — PAID (0.005 USDC). Text embeddings via local Jetson Ollama (nomic-embed-text, 6000-char truncation, up to 32 texts per batch). Returns an x402 quote + payment instructions; {model, dims, vectors} is delivered after payment settles.
- `mnemos_saas_info` — FREE. Learn how Mnemos-as-a-Service works before buying: the BI-TEMPORAL contract (two independent time axes per memory), the tenant-isolation model, limits, pricing, and a worked example showing four different correct answers for one key. No payment, no tenant data. Call this first.
- `mnemos_provision` — PAID (0.50 USDC, monthly floor). Mint your own fully isolated bi-temporal memory namespace. Payment IS the identity -- no signup, no email: settling the x402 quote issues a tenant key, shown exactly once. Returns an x402 quote.
- `mnemos_store` — PAID (0.01 USDC). Store a memory in your isolated bi-temporal namespace. Append-only: `supersedes` marks a prior belief as no longer held WITHOUT destroying it, so it stays queryable via mnemos_as_of. `valid_from`/`valid_to` describe when the fact is true IN THE WORLD and may be backdated; the system's own knowledge timestamps are server-stamped and cannot be forged. Returns an x402 quote; require
- `mnemos_search` — PAID (0.005 USDC). Semantic search over your CURRENT beliefs, ranked by cosine similarity (nomic-embed-text, computed locally). Raw embedding vectors are never returned. Returns an x402 quote; send X-TENANT-KEY once settled.
- `mnemos_get_context` — PAID (0.005 USDC). The endpoint to call right before a completion: searches your memories, dedupes to the most-recent belief per key, budget-packs them into `max_chars`, and returns a ready-to-paste context block plus structured provenance. Content flagged as prompt-injection is excluded from the block. Optionally assembled AS OF a past time. Returns an x402 quote.
- `mnemos_as_of` — PAID (0.005 USDC). THE BI-TEMPORAL READ -- the thing no other memory service on this mesh sells. Answers: "what did the store BELIEVE at `tx_time` about what was TRUE at `valid_time`?" Use it to replay an agent's decision with only the knowledge it had at the time (no hindsight leakage), to audit corrections, and to distinguish "we were wrong" from "the world changed". Returns an x402 quote.

---

Source: https://mcp-skills-hub.vercel.app/mcps/com-virohanalife-mnemos · MCP Skills Hub · data as of 2026-10-28T12:31:05Z
