@getmarrow/mcp 3.9.2 → 3.9.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +486 -84
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,30 +4,463 @@
4
4
 
5
5
  ![npm](https://img.shields.io/npm/v/@getmarrow/mcp)
6
6
  ![npm](https://img.shields.io/npm/dw/@getmarrow/mcp)
7
+ ![npm bundle size](https://img.shields.io/bundlephobia/minzip/@getmarrow/mcp)
8
+ ![GitHub](https://img.shields.io/github/license/MajinBuu0x9/marrow-mcp)
9
+ ![TypeScript](https://img.shields.io/badge/TypeScript-5.3%2B-blue)
10
+ ![Node.js](https://img.shields.io/badge/Node.js-18%2B-green)
7
11
 
8
- `@getmarrow/mcp` connects your Claude, Cursor, or any MCP client to Marrow's collective memory. Every tool call auto-logged, intelligence auto-injected — no agent discipline required.
12
+ Marrow gives your agent a memory that compounds.
13
+
14
+ With `@getmarrow/mcp`, any MCP-compatible client can log intent before acting, inspect live loop state during work, and commit outcomes back to the hive when the work is done. That means your agent stops operating like an amnesiac and starts carrying forward real decision history.
15
+
16
+ **Your agent stops repeating the same mistakes. It learns from prior sessions — and from the wider Marrow hive — through a clean MCP tool surface.**
9
17
 
10
18
  ---
11
19
 
12
- ## Install
20
+ ## Auto-Logging
21
+
22
+ Marrow auto-logs at three layers — transparent to your agent, invisible to you:
23
+
24
+ | Layer | How | Agent effort |
25
+ |-------|-----|-------------|
26
+ | Server-side | Every authenticated API call auto-logged as a decision | Zero |
27
+ | SDK | `marrow.think()` / `marrow.commit()` — explicit control | Minimal |
28
+ | MCP hooks | `npx @getmarrow/mcp setup` — PostToolUse + UserPromptSubmit hooks | Zero |
29
+
30
+ **Passive mode in action:** Run `npx @getmarrow/mcp setup` once. Every tool call your agent makes (Bash, file edits, MCP calls) is auto-logged in the background. Marrow intelligence is auto-injected into your agent's context. Fail-silent, 2-second timeout, never blocks your prompt.
31
+
32
+ Disable: `MARROW_AUTO_HOOK=false`. Debug: `MARROW_HOOK_DEBUG=true`.
33
+
34
+ ---
35
+
36
+ ## Improvement Since Onboarding
37
+
38
+ `marrow_dashboard` and `marrow_digest` now return an `improvement` block comparing your agents' current performance against their day-1 baseline — a frozen snapshot of the first week of activity. Baseline captures automatically once an account reaches 7 days OR 20 decisions (whichever first).
39
+
40
+ Four measured deltas, all from real decision data:
13
41
 
42
+ - `attempts_per_success` — baseline week vs current week
43
+ - `time_to_success_seconds` — median think → successful commit
44
+ - `drift_rate` — % of decisions without a matching prior pattern
45
+ - `success_rate` — baseline vs current outcome fraction
46
+
47
+ Sample response:
48
+
49
+ ```json
50
+ {
51
+ "improvement": {
52
+ "status": "active",
53
+ "days_since_baseline": 20,
54
+ "decisions_since_baseline": 2124,
55
+ "baseline_captured_at": "2026-04-23T15:07:41.919Z",
56
+ "trigger_reason": "time_7d",
57
+ "time_to_success_seconds": { "baseline": 244, "current": 24, "delta_pct": -90.16 }
58
+ }
59
+ }
60
+ ```
61
+
62
+ Accounts with <7 days of activity AND <20 decisions get an onboarding payload showing days/decisions until baseline fires. No heuristics, no estimates — every number comes from the agent's own decision history. Token-usage savings remain on the enterprise roadmap.
63
+
64
+ ---
65
+
66
+ ## What's New in v3.9.3
67
+
68
+ ### Standalone CLI + Multi-API-Key Management
69
+
70
+ **Standalone CLI commands (new in v3.9.0):**
14
71
  ```bash
15
- npm install @getmarrow/mcp
72
+ npx @getmarrow/mcp keys create --name "Prod" --type live
73
+ npx @getmarrow/mcp keys list
74
+ npx @getmarrow/mcp keys rotate --id key_abc123
75
+ npx @getmarrow/mcp keys revoke --id key_abc123
76
+ npx @getmarrow/mcp keys audit --limit 20
77
+ ```
78
+
79
+ **MCP tools (for Claude/Cursor agents):**
80
+
81
+ - `marrow_create_key` — Create named, scoped API keys (`live`/`test` type, optional scopes and agent bindings)
82
+ - `marrow_list_keys` — List all API keys with masked display and tier limits
83
+ - `marrow_get_key` — Get key details, usage stats, and expiry info
84
+ - `marrow_revoke_key` — Permanently revoke a key
85
+ - `marrow_rotate_key` — Atomically rotate (revoke old + create new, returns new key once)
86
+
87
+ Create/rotate return the full key exactly once with a warning. All other tools return masked keys only.
88
+
89
+ ```bash
90
+ npx @getmarrow/mcp --key mrw_...
91
+ # Now available: marrow_create_key, marrow_list_keys, marrow_get_key,
92
+ # marrow_revoke_key, marrow_rotate_key
93
+ ```
94
+
95
+ ---
96
+
97
+ ### Previous: v3.7.0 — Passive Context Injection
98
+
99
+ Marrow's passive loop is now complete. v3.2.0 shipped the **write side** — every tool call your agent makes is auto-logged via a PostToolUse hook. v3.7.0 ships the **read side** — Marrow's intelligence is auto-injected into your agent's prompt window via a UserPromptSubmit hook. No agent discipline required for either side.
100
+
101
+ When you run `npx @getmarrow/mcp setup`, both hooks install automatically. From the next user prompt forward:
102
+
103
+ 1. You type a message to your agent
104
+ 2. Hook fires, takes your prompt, queries Marrow for relevant warnings + hive patterns + similar past decisions
105
+ 3. Marrow context (if any) is injected into your agent's view as `additionalContext`
106
+ 4. Agent responds knowing what failed last time, what worked, and what patterns to leverage
107
+
108
+ The hook is fail-silent: 2-second timeout on the Marrow API call, errors swallowed, never blocks your prompt. No signal → no injection. `MARROW_AUTO_HOOK=false` disables both hooks. `MARROW_CONTEXT_HOOK_DEBUG=true` enables stderr diagnostics.
109
+
110
+ This closes the loop Buu identified: Marrow now *just works* — your agent reads from the hive without you ever telling it to.
111
+
112
+ ---
113
+
114
+ ## Agent-Narrated Marrow Contribution
115
+
116
+ Marrow now tells the agent exactly what it contributed to each decision, so the agent can surface that contribution to the user in plain English — no dashboard required.
117
+
118
+ Three new fields:
119
+
120
+ - `marrow_think` returns `marrow_contributed` describing what intelligence Marrow surfaced for this decision (warnings consulted, hive patterns, similar decisions, workflow templates, loop detection, collective insight).
121
+ - `marrow_commit` returns `marrow_contributed` describing concrete signals on the commit itself (pattern reused, warning avoided, workflow step).
122
+ - `marrow_session_end` returns `session_summary` aggregating Marrow's contribution across the session, plus a one-line `narrative` for the agent to surface as it wraps up.
123
+
124
+ Each object includes `has_signal: boolean` — when true, the agent narrates Marrow's role in 1 sentence; when false, it stays quiet. The built-in `marrow-always-on` system prompt now instructs agents on tone and timing for these narrations.
125
+
126
+ Sample think response:
127
+
128
+ ```json
129
+ {
130
+ "decision_id": "...",
131
+ "intelligence": { "...": "..." },
132
+ "marrow_contributed": {
133
+ "warnings_consulted": 2,
134
+ "hive_patterns_surfaced": 12,
135
+ "similar_decisions_found": 8,
136
+ "workflow_templates_available": 1,
137
+ "loop_detected": false,
138
+ "collective_intelligence": true,
139
+ "team_context_present": false,
140
+ "has_signal": true
141
+ }
142
+ }
143
+ ```
144
+
145
+ The user installed Marrow to make their agent better. They should hear, in plain English, what Marrow actually did. Their agent's reply IS the dashboard.
146
+
147
+ ---
148
+
149
+ ## Agent-Narrated Milestones
150
+
151
+ `marrow_commit` returns a `narrative` field. When a milestone fires (first commit, baseline capture, decision 100/500/1000/5000, weekly recap), the backend returns a human-readable string the agent relays to the user. Otherwise it returns `null`.
152
+
153
+ ```json
154
+ {
155
+ "committed": true,
156
+ "narrative": "Baseline captured. Your first-week averages: 42s per task, 1.3 attempts per success."
157
+ }
16
158
  ```
17
159
 
18
- ## One-Command Setup (Claude Code)
160
+ Narratives are aggregated metrics only — no user data, no decision content, no heuristics.
161
+
162
+ ---
163
+
164
+ ## Velocity Metrics
165
+
166
+ `marrow_dashboard` and `marrow_digest` include three measured velocity metrics:
167
+
168
+ - `attempts_per_success` — avg decisions before an agent lands a success
169
+ - `time_to_success_seconds` — median seconds from `marrow_think` to successful `marrow_commit`
170
+ - `drift_rate` — % of decisions that didn't link to a known pattern
171
+
172
+ Each reports `{current, previous, delta_pct, direction}` so operators see whether agents are trending toward or away from improvement.
173
+
174
+ All metrics are computed from real decision data — no estimates, no heuristics.
175
+
176
+ ---
177
+
178
+ ## Passive Mode
179
+
180
+ Running `npx @getmarrow/mcp setup` installs a PostToolUse hook into `.claude/settings.json`. After setup, every tool call your agent makes (Bash, file edits, MCP calls) is auto-logged to Marrow in the background — no agent discipline required.
181
+
182
+ Disable via: `MARROW_AUTO_HOOK=false`
183
+
184
+ For troubleshooting hook behavior, set `MARROW_HOOK_DEBUG=true` to re-enable one-line stderr diagnostics.
185
+
186
+ **Operator visibility + auto-intelligence tools.**
187
+
188
+ ## Operator Tools
189
+
190
+ ### marrow_dashboard
191
+
192
+ Operator dashboard in one call. Account health, top failures, workflow status, recent activity, Marrow's saves metric. Now includes velocity metrics (see v3.3.0 section above).
193
+
194
+ ### marrow_digest
195
+
196
+ Periodic summary with success rate trend vs previous period. Optional `period` parameter (default `7d`). Now includes velocity summary (see v3.3.0 section above).
197
+
198
+ ### marrow_session_end
199
+
200
+ Explicitly end a session and optionally auto-commit any open decision. Prevents orphaned decisions.
201
+
202
+ ### marrow_accept_detected
203
+
204
+ Convert a detected recurring pattern into an enforced workflow. Pattern ID comes from `orient()` response's `suggested_workflows`.
205
+
206
+ ## Intelligence Fields in marrow_think Response
207
+
208
+ `marrow_think` surfaces three additional fields when the backend provides them:
209
+ - `onboarding_hint` — contextual tip for new accounts
210
+ - `intelligence.collective` — anonymized insights aggregated across all Marrow accounts (k-anonymity ≥5 accounts per insight)
211
+ - `intelligence.team_context` — recent decisions from other sessions in the same account, so multi-agent teams stay aware of each other's work
212
+
213
+ ---
214
+
215
+ ## Available Templates
216
+
217
+ 24 pre-built workflow templates across 8 industries. Browse via `marrow_list_templates` and install with `marrow_install_template`.
218
+
219
+ - **Insurance (4):** `claims-triage`, `fraud-review`, `underwriting-decision`, `complaint-escalation`
220
+ - **Healthcare (4):** `patient-triage`, `clinical-documentation`, `prior-authorization`, `coding-audit`
221
+ - **E-commerce (3):** `order-fulfillment`, `refund-approval`, `return-processing`
222
+ - **Legal (3):** `contract-review`, `case-triage`, `document-discovery`
223
+ - **SaaS (6):** `code-review-deploy`, `incident-response`, `feature-rollout`, `ticket-triage`, `escalation-flow`, `lead-qualify`
224
+ - **Fintech (2):** `etl-pipeline`, `approval-flow`
225
+ - **Media (1):** `content-publish`
226
+ - **Enterprise (1):** `change-management`
227
+
228
+ Full catalog with descriptions: [getmarrow.ai/docs#template-marketplace](https://getmarrow.ai/docs/#template-marketplace)
229
+
230
+ ```
231
+ marrow_list_templates({ industry: 'insurance' })
232
+ marrow_install_template({ slug: 'claims-triage' })
233
+ ```
234
+
235
+ ## Claude Code Compatibility
236
+
237
+ Marrow MCP works natively with Claude Code. The server runs as a long-running process and handles the full MCP protocol correctly.
238
+
239
+ ## One-Command Agent Setup
240
+
241
+ Inject Marrow instructions directly into your project's `CLAUDE.md`:
19
242
 
20
243
  ```bash
21
244
  npx @getmarrow/mcp setup
22
245
  ```
23
246
 
24
- Installs PostToolUse + UserPromptSubmit hooks. Every tool call auto-logs to Marrow. Intelligence auto-injected into your agent's context. Zero agent code required.
247
+ After setup, your agent uses Marrow automatically every session, and Claude Code PostToolUse hooks auto-log tool calls in the background no human prompting required.
25
248
 
26
- Disable: `MARROW_AUTO_HOOK=false`. Debug: `MARROW_HOOK_DEBUG=true`.
249
+ ## Auto-Enroll by Default
250
+ The `marrow-always-on` prompt is served to all MCP clients automatically. Set `MARROW_AUTO_ENROLL=false` to opt out.
27
251
 
28
- ## Manual MCP Config
252
+ ## Security Hardening
253
+ - **Input validation** — all URL path parameters are sanitized to prevent path traversal
254
+ - **SSRF protection** — `MARROW_BASE_URL` must use HTTPS
255
+ - **Crash protection** — malformed JSON on stdin no longer kills the server
256
+ - **Error handling** — proper error logging throughout
257
+ - **HTTP status checking** — API errors return clear messages
29
258
 
30
- Add to your Claude Desktop or MCP client config:
259
+ ### Auto-Warn on Orient
260
+ The `marrow_orient` tool now accepts `autoWarn: true` and warns you BEFORE you start a task that recently failed:
261
+
262
+ ```json
263
+ {
264
+ "name": "marrow_orient",
265
+ "arguments": {
266
+ "autoWarn": true,
267
+ "task": "Fix authentication error"
268
+ }
269
+ }
270
+ ```
271
+
272
+ **Response includes warnings:**
273
+ ```
274
+ ⚠️ HIGH: This task type failed 4x with approach='retry-without-fix'.
275
+ Try approach='apply-patch-first' (89% success rate)
276
+ ```
277
+
278
+ ### Loop Detection on Think
279
+ The `marrow_think` tool now accepts `checkLoop: true` and detects if you're about to retry a failed approach:
280
+
281
+ ```json
282
+ {
283
+ "name": "marrow_think",
284
+ "arguments": {
285
+ "action": "Retry auth with method='internal'",
286
+ "checkLoop": true
287
+ }
288
+ }
289
+ ```
290
+
291
+ **Response includes loop warnings:**
292
+ ```
293
+ 🚨 LOOP DETECTED: You're retrying a failed approach.
294
+ Previous failure: 'retry-without-fix' approach not supported.
295
+ Suggested: Use 'apply-patch-first' approach instead.
296
+ ```
297
+
298
+ ### Rate Limiting
299
+ - `marrow_orient`: 30 requests/minute per account
300
+ - `marrow_think`: 60 requests/minute per account
301
+ - Automatic 429 responses when limit exceeded
302
+
303
+ ### Enhanced PII Protection
304
+ - Automatic stripping of emails, phone numbers, API keys from all responses
305
+ - Applied to `recentLessons`, `warnings`, and `outcome` fields
306
+ - Deep object stripping for complex data structures
307
+
308
+ ---
309
+
310
+ ## The Problem
311
+
312
+ Most agents still operate with shallow memory.
313
+
314
+ They might keep a short context window, maybe write a note or two, then lose the important part:
315
+ - what they were trying to do
316
+ - what they actually did
317
+ - whether it worked
318
+ - what pattern that should teach the next run
319
+
320
+ That creates a familiar failure loop:
321
+ - the same mistakes repeat
322
+ - work gets marked done without structured outcome memory
323
+ - agents drift between sessions
324
+ - hosts have no clean way to inspect whether the work loop is actually closed
325
+
326
+ **Marrow fixes this.**
327
+
328
+ Through MCP, your agent can:
329
+ - orient at session start
330
+ - log intent before meaningful action
331
+ - inspect loop state before handoff or completion
332
+ - commit outcomes back to memory cleanly
333
+
334
+ ---
335
+
336
+ ## How It Works
337
+
338
+ Marrow exposes a simple operating loop through MCP:
339
+
340
+ ```text
341
+ orient -> think -> act -> check -> commit
342
+ ```
343
+
344
+ That gives agents an actual memory discipline:
345
+ - **orient** → pick up recent lessons and current loop state
346
+ - **think** → log intent and receive decision intelligence
347
+ - **act** → perform the meaningful work
348
+ - **check** → inspect whether the loop is still open or missing something
349
+ - **commit** → log the outcome and close the loop
350
+
351
+ The value compounds with use. Each decision your agent logs makes the hive smarter — failure rates drop, patterns emerge, and the next session starts with real intelligence instead of a blank slate. Teams running multiple agents see this compound fastest, but even a single agent builds meaningful history within a few sessions.
352
+
353
+ ---
354
+
355
+ ## Install
356
+
357
+ ### Quick Start (Claude Code)
358
+
359
+ ```bash
360
+ # 1. Add the MCP server
361
+ claude mcp add marrow -e MARROW_API_KEY=mrw_your_api_key -- npx @getmarrow/mcp
362
+
363
+ # 2. Set up auto-enrollment (agent uses Marrow automatically)
364
+ npx @getmarrow/mcp setup
365
+ ```
366
+
367
+ That's it. Your agent will use Marrow automatically in every session.
368
+
369
+ ### Manual Setup
370
+
371
+ Run it directly with `npx`:
372
+
373
+ ```bash
374
+ # Option 1: Pass API key via CLI flag
375
+ npx @getmarrow/mcp --key mrw_your_api_key
376
+
377
+ # Option 2: Use environment variable
378
+ MARROW_API_KEY=mrw_your_api_key npx @getmarrow/mcp
379
+ ```
380
+
381
+ Or register it in your MCP client config.
382
+
383
+ ---
384
+
385
+ ## MCP Tools
386
+
387
+ ### Core Loop Tools
388
+
389
+ #### `marrow_orient`
390
+ **Call this first** at session start. Returns failure warnings from your history so you avoid known mistakes immediately.
391
+
392
+ #### `marrow_think`
393
+ Log intent before meaningful action. Returns pattern insights, similar past decisions, and a recommended next step.
394
+
395
+ #### `marrow_commit`
396
+ Log the outcome after acting. Closes the decision loop.
397
+
398
+ #### `marrow_run`
399
+ Zero-ceremony wrapper. Handles orient → think → commit in a single call.
400
+
401
+ #### `marrow_auto`
402
+ Fire-and-forget logging. Pass what you're about to do (and optionally the outcome). Marrow handles everything in the background.
403
+
404
+ ### Memory Management Tools
405
+
406
+ #### `marrow_list_memories`
407
+ List memories with optional filters:
408
+ - `status` — Filter by status (active, outdated, deleted)
409
+ - `query` — Search query
410
+ - `limit` — Max results
411
+ - `agentId` — Include memories shared with this agent
412
+
413
+ #### `marrow_get_memory`
414
+ Get a single memory by ID.
415
+
416
+ #### `marrow_update_memory`
417
+ Update memory text, tags, or metadata.
418
+
419
+ #### `marrow_delete_memory`
420
+ Soft delete a memory.
421
+
422
+ #### `marrow_mark_outdated`
423
+ Mark a memory as outdated.
424
+
425
+ #### `marrow_supersede_memory`
426
+ Atomically replace a memory with a new version.
427
+
428
+ #### `marrow_share_memory`
429
+ Share a memory with specific agents.
430
+
431
+ #### `marrow_export_memories`
432
+ Export memories to JSON or CSV format.
433
+
434
+ #### `marrow_import_memories`
435
+ Import memories with merge (dedup) or replace mode.
436
+
437
+ #### `marrow_retrieve_memories`
438
+ Full-text search with filters:
439
+ - `query` — Search query (required)
440
+ - `limit` — Max results
441
+ - `from` / `to` — Date range (ISO-8601)
442
+ - `tags` — Comma-separated tags
443
+ - `source` — Source filter
444
+ - `status` — Status filter
445
+ - `shared` — Include shared memories
446
+
447
+ ### Query Tools
448
+
449
+ #### `marrow_ask`
450
+ Query the collective hive in plain English. Ask about failure patterns, what worked, what broke, or get a recommendation.
451
+
452
+ #### `marrow_status`
453
+ Check Marrow platform health and status.
454
+
455
+ ---
456
+
457
+ ## Claude Code Config
458
+
459
+ ```bash
460
+ claude mcp add marrow -e MARROW_API_KEY=mrw_your_api_key -- npx @getmarrow/mcp
461
+ ```
462
+
463
+ ## Claude Desktop Config
31
464
 
32
465
  ```json
33
466
  {
@@ -40,88 +473,57 @@ Add to your Claude Desktop or MCP client config:
40
473
  }
41
474
  ```
42
475
 
43
- ## Core MCP Tools
476
+ ---
44
477
 
45
- | Tool | Description |
46
- |------|-------------|
47
- | `marrow_orient` | Session-start failure warnings |
48
- | `marrow_think` | Log intent + get hive intelligence |
49
- | `marrow_commit` | Record outcome — closes decision loop |
50
- | `marrow_run` | Zero-ceremony: orient → think → commit |
51
- | `marrow_auto` | Fire-and-forget background logging |
52
- | `marrow_dashboard` | Account health, failures, velocity |
53
- | `marrow_digest` | Weekly summary with trends |
54
- | `marrow_session_end` | Close session with summary |
478
+ ## Environment Variables
55
479
 
56
- ### 🆕 v3.9.1 Standalone CLI + Multi-API-Key Management
480
+ | Variable | Required | Description |
481
+ |----------|----------|-------------|
482
+ | `MARROW_API_KEY` | Yes | Your API key from getmarrow.ai (or use `--key` flag) |
483
+ | `MARROW_BASE_URL` | No | Custom API URL (default: `https://api.getmarrow.ai`). Must use HTTPS. |
484
+ | `MARROW_SESSION_ID` | No | Session identifier for multi-agent setups |
485
+ | `MARROW_FLEET_AGENT_ID` | No | Agent identifier sent as `X-Marrow-Agent-Id` for fleet attribution |
486
+ | `MARROW_AUTO_ENROLL` | No | Auto-enrollment prompt (default: `true`). Set to `false` to disable. |
487
+ | `MARROW_AUTO_HOOK` | No | PostToolUse auto-logging kill switch. Set to `false` to disable the hook without editing settings. |
488
+ | `MARROW_HOOK_DEBUG` | No | When set to `true`, the hook emits one-line stderr diagnostics for invalid JSON, missing API key, and runtime failures. |
57
489
 
58
- **Standalone CLI commands:**
59
- ```bash
60
- npx @getmarrow/mcp keys create --name "Prod" --type live
61
- npx @getmarrow/mcp keys list
62
- npx @getmarrow/mcp keys rotate --id key_abc123
63
- npx @getmarrow/mcp keys revoke --id key_abc123
64
- npx @getmarrow/mcp keys audit --limit 20
65
- ```
490
+ ---
66
491
 
67
- **MCP tools (for Claude/Cursor agents):**
492
+ ## The Always-On Prompt
68
493
 
69
- | Tool | Description |
70
- |------|-------------|
71
- | `marrow_create_key` | Create scoped API keys |
72
- | `marrow_list_keys` | List all keys (masked) |
73
- | `marrow_get_key` | Key details + usage stats |
74
- | `marrow_rotate_key` | Atomically rotate a key |
75
- | `marrow_revoke_key` | Permanently revoke |
494
+ Marrow includes a built-in prompt called `marrow-always-on` that instructs agents to use Marrow automatically. It's served by default — no configuration needed.
76
495
 
77
- ### Memory Management Tools
496
+ **To use:** In your MCP client, request the `marrow-always-on` prompt and include it in your system instructions. For Claude Code, run `npx @getmarrow/mcp setup` instead — it handles this automatically.
78
497
 
79
- | Tool | Description |
80
- |------|-------------|
81
- | `marrow_list_memories` | List with filters |
82
- | `marrow_get_memory` | Single memory by ID |
83
- | `marrow_update_memory` | Update text or tags |
84
- | `marrow_delete_memory` | Soft-delete a memory |
85
- | `marrow_share_memory` | Share with specific agents |
498
+ ---
86
499
 
87
- ## Auto-Logging
500
+ ## Why This Matters
501
+
502
+ Without Marrow:
503
+ - Agents repeat the same failures session after session
504
+ - Successful patterns get lost when the context window clears
505
+ - There's no structured trail of what was tried and what worked
506
+ - Every new session starts from zero
507
+
508
+ With Marrow:
509
+ - Failure patterns surface before you repeat them
510
+ - Successful outcomes compound across sessions
511
+ - Every decision has a trail: intent → action → outcome
512
+ - The hive gets smarter with every logged decision
513
+
514
+ **Marrow tells you what went wrong last time before you do it again.**
515
+
516
+ ---
517
+
518
+ ## License
519
+
520
+ MIT
521
+
522
+ ---
523
+
524
+ ## Related Packages
525
+
526
+ - **[@getmarrow/sdk](https://www.npmjs.com/package/@getmarrow/sdk)** — TypeScript/Node.js SDK for programmatic access to Marrow. Use this for custom agent integrations outside of MCP.
88
527
 
89
- Marrow auto-logs at three layers:
90
-
91
- | Layer | How | Effort |
92
- |-------|-----|--------|
93
- | Server-side | Every API call auto-logged | Zero |
94
- | SDK | `marrow.think()` / `marrow.commit()` | Minimal |
95
- | MCP hooks | `npx @getmarrow/mcp setup` | Zero |
96
-
97
- Passive mode: run setup once, auto-logging runs silently forever.
98
-
99
- ## Full Feature Marketplace
100
-
101
- | Category | Features |
102
- |----------|----------|
103
- | 🔁 **Decision Loop** | orient → think → commit with auto-logging |
104
- | 🔐 **Multi-API-Keys** | Create, list, rotate, revoke scoped keys for fleets |
105
- | 🧠 **Persistent Memory** | List, search, update, share, export, import (14 tools) |
106
- | 📊 **Operator Dashboard** | Health, top failures, workflow status, velocity metrics |
107
- | 📈 **Velocity Tracking** | Attempts/success, time-to-success, drift rate, improvement delta |
108
- | 🌐 **Collective Intelligence** | Cross-account anonymous patterns, plain-English query |
109
- | 🔄 **Enforced Workflows** | 24 templates across 8 industries, step-by-step with audit |
110
- | ⚡ **Passive Mode** | npx @getmarrow/mcp setup — zero code auto-logging + hooks |
111
- | 🛡️ **PII Protection** | Auto-strip emails, phones, keys from all responses |
112
- | 🗄️ **Fleet Operations** | Agent registry, multi-user orgs, RBAC, SSE streaming |
113
- | 📋 **Session Management** | Open/close with summaries, pattern reuse tracking |
114
- | 🔗 **Causal Graphs** | Decision chaining — "What happened after this deploy?" |
115
- | 📬 **Auto-Email** | First-decision welcome, 7-day recap, milestone notifications |
116
- | 🔒 **Rate Limiting** | Per-endpoint, per-key, per-IP with tiered limits |
117
- | 📜 **Audit Trail** | Immutable key operation logs with IP and timestamp |
118
-
119
- ## Full Documentation
120
-
121
- 📖 **Complete API reference, metrics, features, and examples:**
122
- **[https://getmarrow.ai/docs](https://getmarrow.ai/docs)**
123
-
124
- - [Auto-Logging](https://getmarrow.ai/docs/#auto-logging)
125
- - [Metrics & Intelligence](https://getmarrow.ai/docs/#metrics-intelligence)
126
- - [API Key Management](https://getmarrow.ai/docs/#api-key-management)
127
- - [API Reference](https://getmarrow.ai/docs/#api-reference)
528
+ **📖 Full API reference with all endpoints:**
529
+ **[getmarrow.ai/docs/#api-reference](https://getmarrow.ai/docs/#api-reference)**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getmarrow/mcp",
3
- "version": "3.9.2",
3
+ "version": "3.9.4",
4
4
  "description": "Your go-to memory provider for all agents, for any AI model.",
5
5
  "bin": {
6
6
  "marrow-mcp": "dist/cli.js"