@mnemoverse/mcp-memory-server 0.1.0 → 0.3.0

package/dist/index.js

@@ -4,6 +4,10 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z } from "zod";
 const API_URL = process.env.MNEMOVERSE_API_URL || "https://core.mnemoverse.com/api/v1";
 const API_KEY = process.env.MNEMOVERSE_API_KEY || "";
+// Hard cap on tool result size — required by Claude Connectors Directory
+// (https://support.claude.com/en/articles/12922490-remote-mcp-server-submission-guide).
+// Approximate token count = chars / 4. Cap at 24,000 tokens to leave headroom under the 25K limit.
+const MAX_RESULT_CHARS = 24_000 * 4;
 if (!API_KEY) {
     console.error("Error: MNEMOVERSE_API_KEY environment variable is required.\n" +
         "Get your free key at https://console.mnemoverse.com");
@@ -24,26 +28,47 @@ async function apiFetch(path, options = {}) {
     }
     return res.json();
 }
+/**
+ * Truncate a result string to MAX_RESULT_CHARS, appending a notice if truncated.
+ * Required by Claude Connectors Directory submission policy.
+ */
+function capResult(text) {
+    if (text.length <= MAX_RESULT_CHARS)
+        return text;
+    const truncated = text.slice(0, MAX_RESULT_CHARS - 200);
+    return (truncated +
+        `\n\n[…truncated to fit 25K token limit. Use a more specific query or smaller top_k to see all results.]`);
+}
 // --- Server setup ---
 const server = new McpServer({
     name: "mnemoverse-memory",
-    version: "0.1.0",
+    version: "0.3.0",
 });
 // --- Tool: memory_write ---
-server.tool("memory_write", "Store a memory — insight, pattern, preference, or fact. Persists across sessions. Use this when the user teaches you something worth remembering, or when you learn a lesson from a task.", {
-    content: z
-        .string()
-        .min(1)
-        .max(10000)
-        .describe("The memory to store — what happened, what was learned"),
-    concepts: z
-        .array(z.string())
-        .optional()
-        .describe("Key concepts for linking related memories (e.g. ['deploy', 'friday', 'staging'])"),
-    domain: z
-        .string()
-        .optional()
-        .describe("Namespace to organize memories (e.g. 'engineering', 'user:alice', 'project:acme')"),
+server.registerTool("memory_write", {
+    description: "Store a memory that should persist across sessions — preferences, decisions, lessons learned, project facts, people and roles. Memories you store are also accessible from Claude, ChatGPT, Cursor, VS Code, and any other AI tool the user connects to Mnemoverse — write once, recall everywhere. Call this PROACTIVELY whenever the user states a preference, makes a decision, or you learn something important. Don't wait to be asked — if it's worth remembering, store it now.",
+    inputSchema: {
+        content: z
+            .string()
+            .min(1)
+            .max(10000)
+            .describe("The memory to store — what happened, what was learned"),
+        concepts: z
+            .array(z.string())
+            .optional()
+            .describe("Key concepts for linking related memories (e.g. ['deploy', 'friday', 'staging'])"),
+        domain: z
+            .string()
+            .optional()
+            .describe("Namespace to organize memories (e.g. 'engineering', 'user:alice', 'project:acme')"),
+    },
+    annotations: {
+        title: "Store Memory",
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
 }, async ({ content, concepts, domain }) => {
     const result = await apiFetch("/memory/write", {
         method: "POST",
@@ -74,23 +99,33 @@ server.tool("memory_write", "Store a memory — insight, pattern, preference, or
     };
 });
 // --- Tool: memory_read ---
-server.tool("memory_read", "Search memories by natural language query. Returns the most relevant stored memories. Use this before starting a task to check if you already know something about it.", {
-    query: z
-        .string()
-        .min(1)
-        .max(5000)
-        .describe("Natural language query — what are you looking for?"),
-    top_k: z
-        .number()
-        .int()
-        .min(1)
-        .max(50)
-        .optional()
-        .describe("Max results to return (default: 5)"),
-    domain: z
-        .string()
-        .optional()
-        .describe("Filter by domain namespace"),
+server.registerTool("memory_read", {
+    description: "ALWAYS call this tool first when the user asks a question about preferences, past decisions, project setup, people, or anything that might have been discussed before. This is your long-term memory — it persists across sessions and tools (Claude, ChatGPT, Cursor, VS Code, and any other AI tool the user connects). Search by natural language query. If you have any doubt whether you know something — check memory first.",
+    inputSchema: {
+        query: z
+            .string()
+            .min(1)
+            .max(5000)
+            .describe("Natural language query — what are you looking for?"),
+        top_k: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .optional()
+            .describe("Max results to return (default: 5)"),
+        domain: z
+            .string()
+            .optional()
+            .describe("Filter by domain namespace"),
+    },
+    annotations: {
+        title: "Search Memories",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
 }, async ({ query, top_k, domain }) => {
     const result = await apiFetch("/memory/read", {
         method: "POST",
@@ -113,26 +148,37 @@ server.tool("memory_read", "Search memories by natural language query. Returns t
         (item.concepts.length > 0
             ? ` (${item.concepts.join(", ")})`
             : ""));
+    const text = lines.join("\n\n") + `\n\n(${r.search_time_ms.toFixed(0)}ms)`;
     return {
         content: [
             {
                 type: "text",
-                text: lines.join("\n\n") + `\n\n(${r.search_time_ms.toFixed(0)}ms)`,
+                text: capResult(text),
             },
         ],
     };
 });
 // --- Tool: memory_feedback ---
-server.tool("memory_feedback", "Report whether a retrieved memory was helpful. Positive feedback makes memories easier to find next time. Negative feedback lets them fade. Call this after using memories from memory_read.", {
-    atom_ids: z
-        .array(z.string())
-        .min(1)
-        .describe("IDs of memories to give feedback on (from memory_read results)"),
-    outcome: z
-        .number()
-        .min(-1)
-        .max(1)
-        .describe("How helpful was this? 1.0 = very helpful, 0 = neutral, -1.0 = harmful/wrong"),
+server.registerTool("memory_feedback", {
+    description: "Report whether a retrieved memory was helpful. Positive feedback makes memories easier to find next time across all tools. Negative feedback lets them fade. Call this after using memories from memory_read.",
+    inputSchema: {
+        atom_ids: z
+            .array(z.string())
+            .min(1)
+            .describe("IDs of memories to give feedback on (from memory_read results)"),
+        outcome: z
+            .number()
+            .min(-1)
+            .max(1)
+            .describe("How helpful was this? 1.0 = very helpful, 0 = neutral, -1.0 = harmful/wrong"),
+    },
+    annotations: {
+        title: "Rate Memory Helpfulness",
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
 }, async ({ atom_ids, outcome }) => {
     const result = await apiFetch("/memory/feedback", {
         method: "POST",
@@ -149,7 +195,17 @@ server.tool("memory_feedback", "Report whether a retrieved memory was helpful. P
     };
 });
 // --- Tool: memory_stats ---
-server.tool("memory_stats", "Get memory statistics — how many memories are stored, which domains exist, average quality scores. Useful for understanding the current state of memory.", {}, async () => {
+server.registerTool("memory_stats", {
+    description: "Get memory statistics — how many memories are stored, which domains exist, average quality scores. These memories are shared with all AI tools the user has connected to Mnemoverse. Useful for understanding the current state of memory.",
+    inputSchema: {},
+    annotations: {
+        title: "Memory Statistics",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+}, async () => {
     const result = await apiFetch("/memory/stats");
     const r = result;
     const text = [
@@ -160,6 +216,85 @@ server.tool("memory_stats", "Get memory statistics — how many memories are sto
     ].join("\n");
     return { content: [{ type: "text", text }] };
 });
+// --- Tool: memory_delete ---
+server.registerTool("memory_delete", {
+    description: "Permanently delete a single memory by its atom_id. Use when the user explicitly asks to forget something specific, or when you stored a wrong fact that needs correcting. The deletion is irreversible — the memory is gone for good. For broad cleanup of an entire topic, prefer memory_delete_domain.",
+    inputSchema: {
+        atom_id: z
+            .string()
+            .min(1)
+            .describe("The atom_id of the memory to delete (from memory_read results — each item has an id)"),
+    },
+    annotations: {
+        title: "Delete a Memory",
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+}, async ({ atom_id }) => {
+    const result = await apiFetch(`/memory/atoms/${encodeURIComponent(atom_id)}`, {
+        method: "DELETE",
+    });
+    // Core API returns { deleted: <count>, atom_id }. count == 0 means
+    // the atom didn't exist (or was already removed). count >= 1 means it was deleted.
+    const r = result;
+    if (!r.deleted) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No memory found with id ${atom_id}.`,
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Deleted memory ${atom_id}.`,
+            },
+        ],
+    };
+});
+// --- Tool: memory_delete_domain ---
+server.registerTool("memory_delete_domain", {
+    description: "Permanently delete ALL memories in a given domain. Use when the user wants to clean up an entire topic — e.g., 'forget everything about project X' or 'wipe my benchmark experiments'. The deletion is irreversible. List domains first with memory_stats to confirm the exact name. Refuse to call this without an explicit user request — it is much more destructive than memory_delete.",
+    inputSchema: {
+        domain: z
+            .string()
+            .min(1)
+            .max(200)
+            .describe("The domain namespace to wipe (e.g., 'project:old', 'experiments-2025'). Must match exactly."),
+        confirm: z
+            .literal(true)
+            .describe("Must be exactly true to proceed. Acts as a safety interlock against accidental invocation."),
+    },
+    annotations: {
+        title: "Delete an Entire Memory Domain",
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+}, async ({ domain, confirm }) => {
+    if (confirm !== true) {
+        throw new Error("memory_delete_domain requires confirm=true as a safety interlock.");
+    }
+    const result = await apiFetch(`/memory/domain/${encodeURIComponent(domain)}`, {
+        method: "DELETE",
+    });
+    const r = result;
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Deleted ${r.deleted} ${r.deleted === 1 ? "memory" : "memories"} from domain "${r.domain}".`,
+            },
+        ],
+    };
+});
 // --- Start ---
 async function main() {
     const transport = new StdioServerTransport();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/docs/configs/claude-code-cli.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+claude mcp add mnemoverse \
+  -e MNEMOVERSE_API_KEY=mk_live_YOUR_KEY \
+  -- npx -y @mnemoverse/mcp-memory-server

package/docs/configs/claude-desktop.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "mnemoverse": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@mnemoverse/mcp-memory-server"
+      ],
+      "env": {
+        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY"
+      }
+    }
+  }
+}

package/docs/configs/cursor-deep-link.txt

@@ -0,0 +1 @@
+cursor://anysphere.cursor-deeplink/mcp/install?name=mnemoverse&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtbmVtb3ZlcnNlL21jcC1tZW1vcnktc2VydmVyIl0sImVudiI6eyJNTkVNT1ZFUlNFX0FQSV9LRVkiOiJta19saXZlX1lPVVJfS0VZIn19

package/docs/configs/cursor.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "mnemoverse": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@mnemoverse/mcp-memory-server"
+      ],
+      "env": {
+        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY"
+      }
+    }
+  }
+}

package/docs/configs/vscode-deep-link.txt

@@ -0,0 +1 @@
+vscode:mcp/install?%7B%22name%22%3A%22mnemoverse%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40mnemoverse%2Fmcp-memory-server%22%5D%2C%22env%22%3A%7B%22MNEMOVERSE_API_KEY%22%3A%22mk_live_YOUR_KEY%22%7D%7D

package/docs/configs/vscode.json

@@ -0,0 +1,15 @@
+{
+  "servers": {
+    "mnemoverse": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "-y",
+        "@mnemoverse/mcp-memory-server"
+      ],
+      "env": {
+        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY"
+      }
+    }
+  }
+}

package/docs/configs/windsurf.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "mnemoverse": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@mnemoverse/mcp-memory-server"
+      ],
+      "env": {
+        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemoverse/mcp-memory-server",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "MCP server for Mnemoverse Memory API — persistent AI memory across Claude Code, Cursor, VS Code, and any MCP client",
   "type": "module",
   "bin": {
@@ -12,8 +12,12 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
+    "generate:configs": "node scripts/generate-configs.mjs",
+    "verify:configs": "node scripts/generate-configs.mjs --check",
+    "prebuild": "npm run generate:configs",
     "prepublishOnly": "npm run build"
   },
+  "mcpName": "io.github.mnemoverse/mcp-memory-server",
   "keywords": [
     "mcp",
     "memory",

package/scripts/generate-configs.mjs

@@ -0,0 +1,306 @@
+#!/usr/bin/env node
+/**
+ * generate-configs.mjs
+ *
+ * Single source of truth → all distribution channel configs.
+ *
+ * Reads: src/configs/source.json
+ * Writes: docs/configs/*, smithery.yaml, server.json
+ *
+ * Usage:
+ *   node scripts/generate-configs.mjs            # generate
+ *   node scripts/generate-configs.mjs --check    # CI: regenerate + diff (fail if changed)
+ *
+ * When you add a new distribution channel, add a new generator function below.
+ * Never edit generated files by hand — they will be overwritten.
+ */
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ROOT = resolve(__dirname, "..");
+
+// ─── Load source ─────────────────────────────────────────────────────────────
+
+const SOURCE_PATH = resolve(ROOT, "src/configs/source.json");
+const source = JSON.parse(readFileSync(SOURCE_PATH, "utf8"));
+
+const PACKAGE_VERSION = JSON.parse(
+  readFileSync(resolve(ROOT, "package.json"), "utf8"),
+).version;
+
+// Helper: extract { KEY: "value" } from source.env (which has nested {value, description, ...})
+function envValues(envObj) {
+  const result = {};
+  for (const [key, meta] of Object.entries(envObj)) {
+    result[key] = meta.value;
+  }
+  return result;
+}
+
+const ENV_VALUES = envValues(source.env);
+
+// ─── Generators ──────────────────────────────────────────────────────────────
+
+/**
+ * Cursor / Claude Desktop / Windsurf format (mcpServers key, stdio).
+ */
+function genMcpServersFormat() {
+  return {
+    mcpServers: {
+      [source.name]: {
+        command: source.command,
+        args: source.args,
+        env: ENV_VALUES,
+      },
+    },
+  };
+}
+
+/**
+ * VS Code (Copilot Chat) format — uses `servers` key (not `mcpServers`).
+ */
+function genVscodeFormat() {
+  return {
+    servers: {
+      [source.name]: {
+        type: source.type,
+        command: source.command,
+        args: source.args,
+        env: ENV_VALUES,
+      },
+    },
+  };
+}
+
+/**
+ * Cursor deep link.
+ *
+ * Format: cursor://anysphere.cursor-deeplink/mcp/install?name=NAME&config=BASE64
+ * The base64 payload is the inner server object (NOT wrapped in mcpServers).
+ */
+function genCursorDeepLink() {
+  const inner = {
+    command: source.command,
+    args: source.args,
+    env: ENV_VALUES,
+  };
+  const config = Buffer.from(JSON.stringify(inner)).toString("base64");
+  return `cursor://anysphere.cursor-deeplink/mcp/install?name=${encodeURIComponent(
+    source.name,
+  )}&config=${config}`;
+}
+
+/**
+ * VS Code deep link.
+ *
+ * Format: vscode:mcp/install?{URL_ENCODED_JSON}
+ * The JSON contains name + the server object (not wrapped in `servers`).
+ */
+function genVscodeDeepLink() {
+  const inner = {
+    name: source.name,
+    type: source.type,
+    command: source.command,
+    args: source.args,
+    env: ENV_VALUES,
+  };
+  return `vscode:mcp/install?${encodeURIComponent(JSON.stringify(inner))}`;
+}
+
+/**
+ * Claude Code CLI command.
+ *
+ * Format: claude mcp add NAME -e KEY=VAL ... -- command args...
+ */
+function genClaudeCodeCli() {
+  const envFlags = Object.entries(ENV_VALUES)
+    .map(([k, v]) => `  -e ${k}=${v}`)
+    .join(" \\\n");
+  return `claude mcp add ${source.name} \\\n${envFlags} \\\n  -- ${source.command} ${source.args.join(" ")}\n`;
+}
+
+/**
+ * Smithery.ai config — custom yaml with configSchema + commandFunction.
+ *
+ * Smithery shows configSchema fields to user as form, then calls commandFunction(config)
+ * to build the launch command.
+ */
+function genSmitheryYaml() {
+  // Build configSchema properties from source.env
+  const schemaProperties = {};
+  const required = [];
+  const camelCaseEnvMap = {}; // Smithery uses camelCase keys, then we map back to ENV_VAR
+
+  for (const [envKey, meta] of Object.entries(source.env)) {
+    // Convert MNEMOVERSE_API_KEY → mnemoverseApiKey
+    const camelKey = envKey
+      .toLowerCase()
+      .split("_")
+      .map((part, i) =>
+        i === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1),
+      )
+      .join("");
+
+    camelCaseEnvMap[camelKey] = envKey;
+    schemaProperties[camelKey] = {
+      type: "string",
+      description: meta.description,
+    };
+    if (meta.required) required.push(camelKey);
+  }
+
+  // Build commandFunction body
+  const envAssignments = Object.entries(camelCaseEnvMap)
+    .map(([camel, envVar]) => `        ${envVar}: config.${camel},`)
+    .join("\n");
+
+  const yaml = `# Smithery configuration — AUTO-GENERATED from src/configs/source.json
+# Do not edit by hand. Run \`npm run generate:configs\` to regenerate.
+# Docs: https://smithery.ai/docs/build/project-config/smithery.yaml
+
+startCommand:
+  type: ${source.type}
+  configSchema:
+    type: object
+    required:
+${required.map((k) => `      - ${k}`).join("\n")}
+    properties:
+${Object.entries(schemaProperties)
+  .map(
+    ([key, prop]) => `      ${key}:
+        type: ${prop.type}
+        description: |
+          ${prop.description}`,
+  )
+  .join("\n")}
+  commandFunction:
+    |-
+    (config) => ({
+      command: '${source.command}',
+      args: ${JSON.stringify(source.args)},
+      env: {
+${envAssignments}
+      }
+    })
+`;
+  return yaml;
+}
+
+/**
+ * Official MCP Registry server.json.
+ *
+ * https://registry.modelcontextprotocol.io/
+ * Schema: https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json
+ */
+function genServerJson() {
+  return {
+    $schema:
+      "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
+    name: "io.github.mnemoverse/mcp-memory-server",
+    description: source.description,
+    repository: {
+      url: source.metadata.repository,
+      source: "github",
+    },
+    version: PACKAGE_VERSION,
+    packages: [
+      {
+        registryName: source.package.registry,
+        name: source.package.name,
+        version: PACKAGE_VERSION,
+        runtimeArguments: source.args.slice(1), // skip "-y"
+        environmentVariables: Object.entries(source.env).map(([key, meta]) => ({
+          name: key,
+          description: meta.description,
+          isRequired: meta.required ?? false,
+          isSecret: meta.secret ?? false,
+        })),
+      },
+    ],
+  };
+}
+
+// ─── Output ──────────────────────────────────────────────────────────────────
+
+const OUTPUTS = [
+  {
+    path: "docs/configs/cursor.json",
+    content: JSON.stringify(genMcpServersFormat(), null, 2) + "\n",
+  },
+  {
+    path: "docs/configs/claude-desktop.json",
+    content: JSON.stringify(genMcpServersFormat(), null, 2) + "\n",
+  },
+  {
+    path: "docs/configs/windsurf.json",
+    content: JSON.stringify(genMcpServersFormat(), null, 2) + "\n",
+  },
+  {
+    path: "docs/configs/vscode.json",
+    content: JSON.stringify(genVscodeFormat(), null, 2) + "\n",
+  },
+  {
+    path: "docs/configs/cursor-deep-link.txt",
+    content: genCursorDeepLink() + "\n",
+  },
+  {
+    path: "docs/configs/vscode-deep-link.txt",
+    content: genVscodeDeepLink() + "\n",
+  },
+  {
+    path: "docs/configs/claude-code-cli.sh",
+    content: "#!/usr/bin/env bash\n" + genClaudeCodeCli(),
+  },
+  {
+    path: "smithery.yaml",
+    content: genSmitheryYaml(),
+  },
+  {
+    path: "server.json",
+    content: JSON.stringify(genServerJson(), null, 2) + "\n",
+  },
+];
+
+// ─── Write files ─────────────────────────────────────────────────────────────
+
+const checkMode = process.argv.includes("--check");
+
+let written = 0;
+let unchanged = 0;
+
+for (const { path, content } of OUTPUTS) {
+  const fullPath = resolve(ROOT, path);
+  mkdirSync(dirname(fullPath), { recursive: true });
+
+  const existing = existsSync(fullPath) ? readFileSync(fullPath, "utf8") : "";
+  if (existing === content) {
+    unchanged++;
+    continue;
+  }
+
+  if (checkMode) {
+    console.error(`✗ Drift detected: ${path}`);
+    console.error("  Expected (regenerated):");
+    console.error("  " + content.slice(0, 200).split("\n").join("\n  "));
+    console.error("  Got (committed):");
+    console.error("  " + existing.slice(0, 200).split("\n").join("\n  "));
+    process.exit(1);
+  }
+
+  writeFileSync(fullPath, content, "utf8");
+  console.log(`✓ Generated ${path}`);
+  written++;
+}
+
+if (checkMode) {
+  console.log(`✓ All ${OUTPUTS.length} configs in sync with source.json`);
+} else {
+  console.log(
+    `\nDone: ${written} written, ${unchanged} unchanged (${OUTPUTS.length} total)`,
+  );
+}

package/server.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
+  "name": "io.github.mnemoverse/mcp-memory-server",
+  "description": "Persistent memory for AI agents — write once, recall anywhere across all your AI tools",
+  "repository": {
+    "url": "https://github.com/mnemoverse/mcp-memory-server",
+    "source": "github"
+  },
+  "version": "0.3.0",
+  "packages": [
+    {
+      "registryName": "npm",
+      "name": "@mnemoverse/mcp-memory-server",
+      "version": "0.3.0",
+      "runtimeArguments": [
+        "@mnemoverse/mcp-memory-server"
+      ],
+      "environmentVariables": [
+        {
+          "name": "MNEMOVERSE_API_KEY",
+          "description": "Your Mnemoverse API key (starts with mk_live_). Get one free at https://console.mnemoverse.com",
+          "isRequired": true,
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}

package/smithery.yaml

@@ -0,0 +1,24 @@
+# Smithery configuration — AUTO-GENERATED from src/configs/source.json
+# Do not edit by hand. Run `npm run generate:configs` to regenerate.
+# Docs: https://smithery.ai/docs/build/project-config/smithery.yaml
+
+startCommand:
+  type: stdio
+  configSchema:
+    type: object
+    required:
+      - mnemoverseApiKey
+    properties:
+      mnemoverseApiKey:
+        type: string
+        description: |
+          Your Mnemoverse API key (starts with mk_live_). Get one free at https://console.mnemoverse.com
+  commandFunction:
+    |-
+    (config) => ({
+      command: 'npx',
+      args: ["-y","@mnemoverse/mcp-memory-server"],
+      env: {
+        MNEMOVERSE_API_KEY: config.mnemoverseApiKey,
+      }
+    })

package/src/configs/source.json

@@ -0,0 +1,28 @@
+{
+  "$comment": "SINGLE SOURCE OF TRUTH for all distribution channel configs. Edit this file → run `npm run generate:configs` → all 9+ artifacts regenerate. CI verifies committed artifacts match source.",
+  "name": "mnemoverse",
+  "displayName": "Mnemoverse Memory",
+  "description": "Persistent memory for AI agents — write once, recall anywhere across all your AI tools",
+  "type": "stdio",
+  "command": "npx",
+  "args": ["-y", "@mnemoverse/mcp-memory-server"],
+  "env": {
+    "MNEMOVERSE_API_KEY": {
+      "value": "mk_live_YOUR_KEY",
+      "description": "Your Mnemoverse API key (starts with mk_live_). Get one free at https://console.mnemoverse.com",
+      "required": true,
+      "secret": true
+    }
+  },
+  "package": {
+    "registry": "npm",
+    "name": "@mnemoverse/mcp-memory-server"
+  },
+  "metadata": {
+    "homepage": "https://mnemoverse.com/docs/api/mcp-server",
+    "repository": "https://github.com/mnemoverse/mcp-memory-server",
+    "license": "MIT",
+    "author": "Mnemoverse",
+    "tags": ["memory", "persistent", "ai-agents", "cross-tool", "oauth"]
+  }
+}

package/src/index.ts

@@ -8,17 +8,22 @@ const API_URL =
   process.env.MNEMOVERSE_API_URL || "https://core.mnemoverse.com/api/v1";
 const API_KEY = process.env.MNEMOVERSE_API_KEY || "";
 
+// Hard cap on tool result size — required by Claude Connectors Directory
+// (https://support.claude.com/en/articles/12922490-remote-mcp-server-submission-guide).
+// Approximate token count = chars / 4. Cap at 24,000 tokens to leave headroom under the 25K limit.
+const MAX_RESULT_CHARS = 24_000 * 4;
+
 if (!API_KEY) {
   console.error(
     "Error: MNEMOVERSE_API_KEY environment variable is required.\n" +
-      "Get your free key at https://console.mnemoverse.com"
+      "Get your free key at https://console.mnemoverse.com",
   );
   process.exit(1);
 }
 
 async function apiFetch(
   path: string,
-  options: RequestInit = {}
+  options: RequestInit = {},
 ): Promise<unknown> {
   const res = await fetch(`${API_URL}${path}`, {
     ...options,
@@ -37,32 +42,59 @@ async function apiFetch(
   return res.json();
 }
 
+/**
+ * Truncate a result string to MAX_RESULT_CHARS, appending a notice if truncated.
+ * Required by Claude Connectors Directory submission policy.
+ */
+function capResult(text: string): string {
+  if (text.length <= MAX_RESULT_CHARS) return text;
+  const truncated = text.slice(0, MAX_RESULT_CHARS - 200);
+  return (
+    truncated +
+    `\n\n[…truncated to fit 25K token limit. Use a more specific query or smaller top_k to see all results.]`
+  );
+}
+
 // --- Server setup ---
 
 const server = new McpServer({
   name: "mnemoverse-memory",
-  version: "0.1.0",
+  version: "0.3.0",
 });
 
 // --- Tool: memory_write ---
 
-server.tool(
+server.registerTool(
   "memory_write",
-  "Store a memory — insight, pattern, preference, or fact. Persists across sessions. Use this when the user teaches you something worth remembering, or when you learn a lesson from a task.",
   {
-    content: z
-      .string()
-      .min(1)
-      .max(10000)
-      .describe("The memory to store — what happened, what was learned"),
-    concepts: z
-      .array(z.string())
-      .optional()
-      .describe("Key concepts for linking related memories (e.g. ['deploy', 'friday', 'staging'])"),
-    domain: z
-      .string()
-      .optional()
-      .describe("Namespace to organize memories (e.g. 'engineering', 'user:alice', 'project:acme')"),
+    description:
+      "Store a memory that should persist across sessions — preferences, decisions, lessons learned, project facts, people and roles. Memories you store are also accessible from Claude, ChatGPT, Cursor, VS Code, and any other AI tool the user connects to Mnemoverse — write once, recall everywhere. Call this PROACTIVELY whenever the user states a preference, makes a decision, or you learn something important. Don't wait to be asked — if it's worth remembering, store it now.",
+    inputSchema: {
+      content: z
+        .string()
+        .min(1)
+        .max(10000)
+        .describe("The memory to store — what happened, what was learned"),
+      concepts: z
+        .array(z.string())
+        .optional()
+        .describe(
+          "Key concepts for linking related memories (e.g. ['deploy', 'friday', 'staging'])",
+        ),
+      domain: z
+        .string()
+        .optional()
+        .describe(
+          "Namespace to organize memories (e.g. 'engineering', 'user:alice', 'project:acme')",
+        ),
+    },
+    annotations: {
+      title: "Store Memory",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
   },
   async ({ content, concepts, domain }) => {
     const result = await apiFetch("/memory/write", {
@@ -99,31 +131,41 @@ server.tool(
         },
       ],
     };
-  }
+  },
 );
 
 // --- Tool: memory_read ---
 
-server.tool(
+server.registerTool(
   "memory_read",
-  "Search memories by natural language query. Returns the most relevant stored memories. Use this before starting a task to check if you already know something about it.",
   {
-    query: z
-      .string()
-      .min(1)
-      .max(5000)
-      .describe("Natural language query — what are you looking for?"),
-    top_k: z
-      .number()
-      .int()
-      .min(1)
-      .max(50)
-      .optional()
-      .describe("Max results to return (default: 5)"),
-    domain: z
-      .string()
-      .optional()
-      .describe("Filter by domain namespace"),
+    description:
+      "ALWAYS call this tool first when the user asks a question about preferences, past decisions, project setup, people, or anything that might have been discussed before. This is your long-term memory — it persists across sessions and tools (Claude, ChatGPT, Cursor, VS Code, and any other AI tool the user connects). Search by natural language query. If you have any doubt whether you know something — check memory first.",
+    inputSchema: {
+      query: z
+        .string()
+        .min(1)
+        .max(5000)
+        .describe("Natural language query — what are you looking for?"),
+      top_k: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .describe("Max results to return (default: 5)"),
+      domain: z
+        .string()
+        .optional()
+        .describe("Filter by domain namespace"),
+    },
+    annotations: {
+      title: "Search Memories",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true,
+    },
   },
   async ({ query, top_k, domain }) => {
     const result = await apiFetch("/memory/read", {
@@ -159,35 +201,47 @@ server.tool(
         `${i + 1}. [${(item.relevance * 100).toFixed(0)}%] ${item.content}` +
         (item.concepts.length > 0
           ? ` (${item.concepts.join(", ")})`
-          : "")
+          : ""),
     );
 
+    const text = lines.join("\n\n") + `\n\n(${r.search_time_ms.toFixed(0)}ms)`;
+
     return {
       content: [
         {
           type: "text" as const,
-          text: lines.join("\n\n") + `\n\n(${r.search_time_ms.toFixed(0)}ms)`,
+          text: capResult(text),
         },
       ],
     };
-  }
+  },
 );
 
 // --- Tool: memory_feedback ---
 
-server.tool(
+server.registerTool(
   "memory_feedback",
-  "Report whether a retrieved memory was helpful. Positive feedback makes memories easier to find next time. Negative feedback lets them fade. Call this after using memories from memory_read.",
   {
-    atom_ids: z
-      .array(z.string())
-      .min(1)
-      .describe("IDs of memories to give feedback on (from memory_read results)"),
-    outcome: z
-      .number()
-      .min(-1)
-      .max(1)
-      .describe("How helpful was this? 1.0 = very helpful, 0 = neutral, -1.0 = harmful/wrong"),
+    description:
+      "Report whether a retrieved memory was helpful. Positive feedback makes memories easier to find next time across all tools. Negative feedback lets them fade. Call this after using memories from memory_read.",
+    inputSchema: {
+      atom_ids: z
+        .array(z.string())
+        .min(1)
+        .describe("IDs of memories to give feedback on (from memory_read results)"),
+      outcome: z
+        .number()
+        .min(-1)
+        .max(1)
+        .describe("How helpful was this? 1.0 = very helpful, 0 = neutral, -1.0 = harmful/wrong"),
+    },
+    annotations: {
+      title: "Rate Memory Helpfulness",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
   },
   async ({ atom_ids, outcome }) => {
     const result = await apiFetch("/memory/feedback", {
@@ -205,15 +259,25 @@ server.tool(
         },
       ],
     };
-  }
+  },
 );
 
 // --- Tool: memory_stats ---
 
-server.tool(
+server.registerTool(
   "memory_stats",
-  "Get memory statistics — how many memories are stored, which domains exist, average quality scores. Useful for understanding the current state of memory.",
-  {},
+  {
+    description:
+      "Get memory statistics — how many memories are stored, which domains exist, average quality scores. These memories are shared with all AI tools the user has connected to Mnemoverse. Useful for understanding the current state of memory.",
+    inputSchema: {},
+    annotations: {
+      title: "Memory Statistics",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true,
+    },
+  },
   async () => {
     const result = await apiFetch("/memory/stats");
 
@@ -235,7 +299,114 @@ server.tool(
     ].join("\n");
 
     return { content: [{ type: "text" as const, text }] };
-  }
+  },
+);
+
+// --- Tool: memory_delete ---
+
+server.registerTool(
+  "memory_delete",
+  {
+    description:
+      "Permanently delete a single memory by its atom_id. Use when the user explicitly asks to forget something specific, or when you stored a wrong fact that needs correcting. The deletion is irreversible — the memory is gone for good. For broad cleanup of an entire topic, prefer memory_delete_domain.",
+    inputSchema: {
+      atom_id: z
+        .string()
+        .min(1)
+        .describe(
+          "The atom_id of the memory to delete (from memory_read results — each item has an id)",
+        ),
+    },
+    annotations: {
+      title: "Delete a Memory",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: true,
+    },
+  },
+  async ({ atom_id }) => {
+    const result = await apiFetch(`/memory/atoms/${encodeURIComponent(atom_id)}`, {
+      method: "DELETE",
+    });
+
+    // Core API returns { deleted: <count>, atom_id }. count == 0 means
+    // the atom didn't exist (or was already removed). count >= 1 means it was deleted.
+    const r = result as { deleted: number; atom_id?: string };
+
+    if (!r.deleted) {
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `No memory found with id ${atom_id}.`,
+          },
+        ],
+      };
+    }
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: `Deleted memory ${atom_id}.`,
+        },
+      ],
+    };
+  },
+);
+
+// --- Tool: memory_delete_domain ---
+
+server.registerTool(
+  "memory_delete_domain",
+  {
+    description:
+      "Permanently delete ALL memories in a given domain. Use when the user wants to clean up an entire topic — e.g., 'forget everything about project X' or 'wipe my benchmark experiments'. The deletion is irreversible. List domains first with memory_stats to confirm the exact name. Refuse to call this without an explicit user request — it is much more destructive than memory_delete.",
+    inputSchema: {
+      domain: z
+        .string()
+        .min(1)
+        .max(200)
+        .describe(
+          "The domain namespace to wipe (e.g., 'project:old', 'experiments-2025'). Must match exactly.",
+        ),
+      confirm: z
+        .literal(true)
+        .describe(
+          "Must be exactly true to proceed. Acts as a safety interlock against accidental invocation.",
+        ),
+    },
+    annotations: {
+      title: "Delete an Entire Memory Domain",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: true,
+    },
+  },
+  async ({ domain, confirm }) => {
+    if (confirm !== true) {
+      throw new Error(
+        "memory_delete_domain requires confirm=true as a safety interlock.",
+      );
+    }
+
+    const result = await apiFetch(`/memory/domain/${encodeURIComponent(domain)}`, {
+      method: "DELETE",
+    });
+
+    const r = result as { deleted: number; domain: string };
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: `Deleted ${r.deleted} ${r.deleted === 1 ? "memory" : "memories"} from domain "${r.domain}".`,
+        },
+      ],
+    };
+  },
 );
 
 // --- Start ---