From 6f6f95b6ab4fad969c82f239dddf95a7fb6cd7fd Mon Sep 17 00:00:00 2001 From: yixin Date: Wed, 20 May 2026 23:01:06 +0800 Subject: [PATCH 1/3] docs: sync MCP tool counts across metadata --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 840a75c420..bc9a4c6c83 100644 --- a/README.md +++ b/README.md @@ -424,7 +424,7 @@ codex plugin install agentmemory The Codex plugin ships from the same `plugin/` directory as the Claude Code plugin. It registers: -- `@agentmemory/mcp` as an MCP server (proxies all 51 tools when `AGENTMEMORY_URL` points at a running agentmemory server; falls back to 7 tools locally when no server is reachable) +- `@agentmemory/mcp` as an MCP server (proxies all 53 tools when `AGENTMEMORY_URL` points at a running agentmemory server; falls back to 7 tools locally when no server is reachable) - 6 lifecycle hooks: `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `PreCompact`, `Stop` - 4 skills: `/recall`, `/remember`, `/session-history`, `/forget` @@ -446,7 +446,7 @@ This adds an idempotent block to `~/.codex/hooks.json` referencing absolute path OpenClaw (paste this prompt) ``` -Install agentmemory for OpenClaw. Run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server on localhost:3111. Then add this to my OpenClaw MCP config so agentmemory is available with all 51 memory tools: +Install agentmemory for OpenClaw. Run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server on localhost:3111. Then add this to my OpenClaw MCP config so agentmemory is available with all 53 memory tools: { "mcpServers": { @@ -471,7 +471,7 @@ Full guide: [`integrations/openclaw/`](integrations/openclaw/) Hermes Agent (paste this prompt) ``` -Install agentmemory for Hermes. Run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server on localhost:3111. Then add this to ~/.hermes/config.yaml so Hermes can use agentmemory as an MCP server with all 51 memory tools: +Install agentmemory for Hermes. Run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server on localhost:3111. Then add this to ~/.hermes/config.yaml so Hermes can use agentmemory as an MCP server with all 53 memory tools: mcp_servers: agentmemory: @@ -801,9 +801,9 @@ npm install @xenova/transformers 53 tools, 6 resources, 3 prompts, and 4 skills — the most comprehensive MCP memory toolkit for any agent. -> **MCP shim vs full server:** the published `@agentmemory/mcp` package is a thin shim. It exposes the full 51-tool surface **only when it can reach a running agentmemory server** via `AGENTMEMORY_URL` (proxy mode). With no server reachable, the shim falls back to a 7-tool local set (`memory_save`, `memory_recall`, `memory_smart_search`, `memory_sessions`, `memory_export`, `memory_audit`, `memory_governance_delete`). The `AGENTMEMORY_TOOLS=core|all` env var is a *server-side* flag — setting it in the shim's `env` block has no effect. If you see only 7 tools in Cursor / OpenCode / Gemini CLI, start `npx @agentmemory/agentmemory` (or the Docker stack) and set `AGENTMEMORY_URL=http://localhost:3111`. +> **MCP shim vs full server:** the published `@agentmemory/mcp` package is a thin shim. It exposes the full 53-tool surface **only when it can reach a running agentmemory server** via `AGENTMEMORY_URL` (proxy mode). With no server reachable, the shim falls back to a 7-tool local set (`memory_save`, `memory_recall`, `memory_smart_search`, `memory_sessions`, `memory_export`, `memory_audit`, `memory_governance_delete`). The `AGENTMEMORY_TOOLS=core|all` env var is a *server-side* flag — setting it in the shim's `env` block has no effect. If you see only 7 tools in Cursor / OpenCode / Gemini CLI, start `npx @agentmemory/agentmemory` (or the Docker stack) and set `AGENTMEMORY_URL=http://localhost:3111`. -### 51 Tools +### 53 Tools
Core tools (always available) @@ -825,7 +825,7 @@ npm install @xenova/transformers
-Extended tools (51 total — set AGENTMEMORY_TOOLS=all) +Extended tools (53 total — set AGENTMEMORY_TOOLS=all) | Tool | Description | |------|-------------| @@ -1189,7 +1189,7 @@ Create `~/.agentmemory/.env`: # USER_ID= # TEAM_MODE=private -# Tool visibility: "core" (8 tools) or "all" (51 tools) +# Tool visibility: "core" (8 tools) or "all" (53 tools) # AGENTMEMORY_TOOLS=core ``` From a56fe9d3a93e1d5302855ded4db960d476ab0a19 Mon Sep 17 00:00:00 2001 From: yixin Date: Wed, 20 May 2026 23:29:14 +0800 Subject: [PATCH 2/3] docs: align default MCP tools table with core mode --- README.md | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index bc9a4c6c83..dcd7851d08 100644 --- a/README.md +++ b/README.md @@ -806,21 +806,18 @@ npm install @xenova/transformers ### 53 Tools
-Core tools (always available) +Default tools (AGENTMEMORY_TOOLS=core) | Tool | Description | |------|-------------| | `memory_recall` | Search past observations | -| `memory_compress_file` | Compress markdown files while preserving structure | | `memory_save` | Save an insight, decision, or pattern | -| `memory_patterns` | Detect recurring patterns | -| `memory_smart_search` | Hybrid semantic + keyword search | -| `memory_file_history` | Past observations about specific files | | `memory_sessions` | List recent sessions | -| `memory_timeline` | Chronological observations | -| `memory_profile` | Project profile (concepts, files, patterns) | -| `memory_export` | Export all memory data | -| `memory_relations` | Query relationship graph | +| `memory_smart_search` | Hybrid semantic + keyword search | +| `memory_consolidate` | Run 4-tier consolidation | +| `memory_diagnose` | Health diagnostics | +| `memory_lesson_save` | Save reusable lessons | +| `memory_reflect` | Synthesize lessons from memories |
From 83e9dabef3f7da0d9e3246cbb9f1de943d9ccb99 Mon Sep 17 00:00:00 2001 From: yixin Date: Thu, 21 May 2026 00:02:53 +0800 Subject: [PATCH 3/3] docs: sync MCP tool counts across metadata --- .env.example | 2 +- plugin/.claude-plugin/plugin.json | 2 +- src/mcp/standalone.ts | 2 +- website/components/Compare.tsx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.env.example b/.env.example index 77ca0f3a38..54d246bbea 100644 --- a/.env.example +++ b/.env.example @@ -119,7 +119,7 @@ # 6. CLI / runtime knobs # ----------------------------------------------------------------------------- -# AGENTMEMORY_TOOLS=all # core (7 tools, default) | all (51 tools) — surface exposed to MCP clients +# AGENTMEMORY_TOOLS=all # core (8 tools, default) | all (53 tools) — server surface exposed to MCP clients # AGENTMEMORY_SLOTS=memory # Comma-separated plugin slot names the CLI should claim # AGENTMEMORY_DEBUG=1 # Trace MCP shim probe + standalone fallback decisions to stderr # AGENTMEMORY_FORCE_PROXY=1 # Skip the MCP shim livez probe and trust AGENTMEMORY_URL (for sandboxed MCP clients that can't reach localhost) diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json index e53f8088d2..889a018fd7 100644 --- a/plugin/.claude-plugin/plugin.json +++ b/plugin/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "agentmemory", "version": "0.9.21", - "description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 12 hooks, 51 MCP tools, 4 skills, real-time viewer.", + "description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 12 hooks, 53 MCP tools, 4 skills, real-time viewer.", "author": { "name": "Rohit Ghumare", "url": "https://github.com/rohitg00" diff --git a/src/mcp/standalone.ts b/src/mcp/standalone.ts index 1413cbf804..4b68d18151 100644 --- a/src/mcp/standalone.ts +++ b/src/mcp/standalone.ts @@ -327,7 +327,7 @@ async function handleProxyGeneric( handle: ProxyHandle, ): Promise<{ content: Array<{ type: string; text: string }> }> { // Forward to the server's full MCP surface so non-Claude clients can - // reach all 51 tools (lessons, sentinels, slots, signals, graph, …) + // reach all 53 tools (lessons, sentinels, slots, signals, graph, …) // instead of being capped at the 7 IMPLEMENTED_TOOLS set baked into // this shim. The server validates arguments per tool. const result = (await handle.call("/agentmemory/mcp/call", { diff --git a/website/components/Compare.tsx b/website/components/Compare.tsx index d743850f0e..f311f8b437 100644 --- a/website/components/Compare.tsx +++ b/website/components/Compare.tsx @@ -4,7 +4,7 @@ const ROWS = [ ["RETRIEVAL R@5", "95.2%", "81.4%", "73.8%", "78.1%"], ["EXTERNAL DEPS", "0", "2 (Qdrant, Neo4j)", "1 (Postgres)", "1 (Neo4j)"], ["REST ENDPOINTS", "121", "—", "—", "—"], - ["MCP TOOLS", "51", "12", "18", "9"], + ["MCP TOOLS", "53", "12", "18", "9"], ["AUTO-HOOKS", "12", "0", "0", "0"], ["NATIVE PLUGINS", "6", "—", "—", "—"], ["OPEN SOURCE", "YES (APACHE-2.0)", "YES", "YES", "YES"],