Skip to content

API Reference

ToolDescription
mem_statusCheck server connection status and stats
mem_addStore a memory (content, tags, namespace)
mem_searchHybrid search (BM25 + vector + RRF)
mem_recallRetrieve a single memory by ID
mem_listList memories (filter, pagination)
mem_readRead a source file
mem_indexIndex a path or file
mem_statsIndex/search statistics
mem_doMeta-tool — routes non-core actions in core mode for minimal context usage
ToolDescription
mem_agent_registerRegister an agent (id, description)
mem_agent_searchSearch agent namespace + shared
mem_agent_shareExport a memory to the shared namespace
ToolDescription
mem_tagTag management (add, remove, list)
mem_namespaceNamespace management
mem_healthIndex health diagnostics
mem_cleanupClean up expired/duplicate memories

See the memtomem repository docs for the full list of 74 tools.

In addition to proxied upstream tools, STM provides its own management tools:

ToolDescription
stm_statusSTM proxy status
stm_cache_statsResponse cache statistics
stm_cache_clearClear cache
stm_compression_statsPer-strategy compression statistics
stm_surfacing_statsSurfacing statistics (hit rate, feedback)
stm_feedbackSubmit surfacing/compression quality feedback
Terminal window
mm init # interactive setup wizard
mm serve # start MCP server
mm web # launch Web UI dashboard
mm search <query> # search from CLI
mm index <path> # index from CLI
mm ingest claude-memory # ingest Claude Code memories
mm ingest gemini-memory # ingest Gemini CLI memories
mm ingest codex-memory # ingest Codex CLI memories
mm context sync # Context Gateway sync
mm context import # runtime files → canonical source
Terminal window
mms add <name> --command <cmd> --args <args> --prefix <prefix>
# register upstream MCP server
mms list # list registered servers
mms remove <name> # remove a server
mms serve # start STM proxy
mms stats # proxy statistics

Key settings are controlled via environment variables. See the Configuration docs in each repository for the full list.

VariableDescriptionDefault
MEMTOMEM_EMBEDDING_PROVIDEREmbedding provider (onnx/ollama/openai)onnx
MEMTOMEM_DB_PATHSQLite DB path~/.memtomem/memtomem.db
MEMTOMEM_STM_COMPRESSIONDefault compression strategyauto
MEMTOMEM_STM_SURFACINGEnable surfacingtrue