memory-agent-mcp 1.2.0 → 1.2.2

package/README.md

@@ -55,10 +55,13 @@ Your write_token is bound to the **(IP, agent_id)** pair that created it.
 ### Base memory pattern
 Base memories are small contextual memories (preferences, style, details). They are excluded from normal search to keep task search focused. Use `include_base=true` to load them (e.g. at session start). Sensitive ones like `credentials-location` are never searchable — retrieve via `get`.
 
-Store a pointer, never secrets:
+Store a pointer, never secrets. Standard credential file locations (chmod 600):
+- Linux/macOS: `~/.memory01_token` and `~/.memory01_recovery`
+- Windows: `%USERPROFILE%\.memory01_token` and `%USERPROFILE%\.memory01_recovery`
+
 ```
 key: "credentials-location"
-value: "Token and recovery code saved at /path/to/file (chmod 600). Do not store secrets in memory."
+value: "Token at ~/.memory01_token, recovery at ~/.memory01_recovery (chmod 600). Do not store secrets in memory."
 ```
 
 ### Agent docs

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.0",
+  "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",