Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
THESEUSMEM_AGENTNoCaller agent tag for cross-agent attribution.default
THESEUSMEM_DB_PATHNoShared SQLite memory database path.~/.theseusmem/memory.db
THESEUSMEM_DICT_PATHNoOptional YAML domain dictionary for tokenization and synonym expansion. Unset by default.
THESEUSMEM_EMBED_URLNoOptional OpenAI-compatible /v1 embeddings endpoint.http://127.0.0.1:7861/v1
THESEUSMEM_READ_ONLYNoSet to 1 to disable remember_fact writes.0
THESEUSMEM_EMBED_MODELNoEmbedding model identifier.Qwen/Qwen3-Embedding-0.6B
THESEUSMEM_REFERENCE_DIRNoCold-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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.1/5.0

Scored across 9 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness3/5

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.