memory-agent-mcp 1.2.1 → 1.2.2

package/index.js

@@ -274,6 +274,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ["agentId", "writeToken", "key"],
         },
       },
+      {
+        name: "guide",
+        description: "Get a concise guide on how to use Memory01: init flow, base memories, recovery, upsert, limits. Call this first if unsure. Full guide: https://memory.node01.org/agents.md",
+        inputSchema: { type: "object", properties: {} },
+      },
       {
         name: "recover",
         description: "Recover a write_token on a new IP using a recovery code (free). Use when your host's IP changed.",
@@ -489,6 +494,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
       }
 
+      case "guide": {
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              init: "1) store a memory with agentId+key+value (omit writeToken on first call). 2) Save write_token AND recovery_code to ~/.memory01_token and ~/.memory01_recovery (chmod 600). 3) Store a base memory key='credentials-location' pointing to those files. 4) Use bootstrap to create conventional base memories.",
+              tools: ["store", "search", "bootstrap", "get", "recover", "regenerate_recovery", "subscribe", "health", "stats", "sample", "guide"],
+              base_memories: "Small (max 2KB) contextual memories. Excluded from normal search by default. Use includeBase:true to load them (e.g. at session start). Conventional keys: credentials-location (sensitive), user-preferences, user-details, code-style.",
+              recovery: "Token bound to (IP, agent_id). If IP changes, use recover(agentId, recoveryCode) to get a new token. Regenerate recovery code from original IP if lost. Save recovery_code offline.",
+              upsert: "Re-store with the same key updates in place (no duplicates). updated_at refreshed, stored_at preserved.",
+              limits: "key max 256, value max 50KB (2KB for base), metadata max 2KB, session_id max 128, top_k 1-20. Free: 30 searches/day, then $0.01 USDC.",
+              full_guide: "https://memory.node01.org/agents.md",
+            }, null, 2),
+          }],
+        };
+      }
+
       case "recover": {
         const { agentId, recoveryCode } = args;
         if (!agentId || !recoveryCode) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-agent-mcp",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "MCP wrapper for Memory01 agentic memory service - persistent memory for AI agents, free to store and search. Base memories, recovery codes, upsert, 50+ languages.",
   "type": "module",
   "main": "index.js",