theseusmem-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| THESEUSMEM_AGENT | No | Caller agent tag for cross-agent attribution. | default |
| THESEUSMEM_DB_PATH | No | Shared SQLite memory database path. | ~/.theseusmem/memory.db |
| THESEUSMEM_DICT_PATH | No | Optional YAML domain dictionary for tokenization and synonym expansion. Unset by default. | |
| THESEUSMEM_EMBED_URL | No | Optional OpenAI-compatible /v1 embeddings endpoint. | http://127.0.0.1:7861/v1 |
| THESEUSMEM_READ_ONLY | No | Set to 1 to disable remember_fact writes. | 0 |
| THESEUSMEM_EMBED_MODEL | No | Embedding model identifier. | Qwen/Qwen3-Embedding-0.6B |
| THESEUSMEM_REFERENCE_DIR | No | Cold-layer Markdown reference directory. | ~/.theseusmem/reference |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_factsB | Search structured long-term facts across all connected agents. Uses multi-path hybrid retrieval (FTS5 + jieba + Jaccard + HRR + optional embeddings + entity graph). Optionally filter by category or source_agent (e.g. "claude-code", "cursor"). |
| search_episodesB | Search raw episodic conversation turns (FTS5 + synonym expansion + optional vectors). |
| recall_entityC | Probe all facts associated with an entity using HRR algebraic unbinding. |
| get_factB | Fetch full metadata and content for a single fact by fact_id. |
| get_timelineB | Fetch surrounding conversation turns around a given episode_id. |
| list_factsC | List high-trust facts filtered by optional category. |
| remember_factB | Deduplicate and persist a durable fact, preference, or decision into the shared store. Tags the entry with source_agent (or THESEUSMEM_AGENT) for cross-agent attribution. |
| search_referenceC | Progressive reader/search over cold-layer Markdown files in THESEUSMEM_REFERENCE_DIR. |
| memory_statsB | Return memory store statistics, cross-agent sources, weights, and dependency status. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Most tools target distinct resources: facts, episodes, entities, timelines, reference files, and stats. However, search_facts, list_facts, and recall_entity all return facts and could be confused without careful reading; descriptions partially clarify the boundaries.
Nearly all tools use a consistent snake_case verb_noun pattern (search_facts, get_fact, remember_fact, etc.). memory_stats is the main deviation, using a noun phrase instead of a verb, but overall the naming is predictable.
Nine tools is well-scoped for a memory server, covering search, retrieval, persistence, entity recall, timelines, references, and stats. Each tool appears to earn its place without obvious redundancy.
The server covers creation and rich read paths for facts, episodes, and references, but lacks explicit update, delete, or forget operations. For a long-term memory store, the absence of deletion/forgetting and episode write operations is a notable lifecycle gap.