Tool reference · Maintenance & performance
memory_stats
Reports how much is stored in memory and how healthy it is: record counts, projects, stale items, storage size and configuration.
local stdio server read-only
When to use
- You want to check the memory store is working after installation.
- Recall feels noisy and you want to see how many records are stale or never recalled.
- You need disk usage or the active embedding model.
Parameters
This tool takes no parameters.
Example
Arguments
{}Result shape
{
"sessions": 412,
"knowledge": {
"active": 3870,
"archived": 214,
"consolidated": 96,
"superseded": 188
},
"by_type": {
"fact": 1402,
"solution": 1120,
"decision": 640,
"lesson": 470,
"convention": 238
},
"by_project": {
"billing-api": 1210,
"general": 902
},
"health": {
"stale_90d": 310,
"never_recalled": 1204,
"health_score": 0.87
},
"timeline_events": 9124,
"storage_mb": {
"transcripts": 81.2,
"raw_logs": 3.4,
"sqlite": 142.7,
"chroma": 0,
"embeddings": 18.9,
"total": 227.3
},
"config": {
"embed_mode": "fastembed",
"binary_search_active": true,
"embeddings_count": 3870
},
"cache": {
"enabled": true
}
}Shortened. The full result also has v6_queues, v6_storage, v6_filter_savings, v6_llm, self_improvement and observations blocks, and more config fields.
Values are illustrative; the keys follow the server's handler. MCP clients receive the result as JSON text content.
Server description
The description the server sends to your agent in tools/list, captured from the v14.7.0 source:
Memory statistics with health metrics: sessions, knowledge by type/project, retention zones (active/archived/consolidated), stale records, storage size, config.