Skip to main content
Glama
cuemap-dev

CueMap MCP Server

Official
by cuemap-dev

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CUEMAP_URLNoIf you prefer to bypass the embedded engine and connect to a remotely hosted or separately running CueMap server, specify its URL here (e.g. http://localhost:8735).
CUEMAP_PORTNoOverride the port the embedded engine binds to (default: 8735).8735
CUEMAP_PROJECTNoOverride the default project. Without this setting, CueMap derives a stable repository-scoped project from the current Git remote or working directory.
CUEMAP_LOG_PATHNoOverride the embedded engine log path. It defaults to ~/.cuemap/server.log, which is the file read by cuemap logs.
CUEMAP_CONFIG_PATHNoAbsolute path to a custom server_config.toml to configure advanced Engine tuning, background jobs, and RAG search parameters.

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": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
cuemap_init_previewA

Preview supported repository files without ingesting content. Call this before first-time repository initialization, present the grouped paths to the user, and ask them to confirm or adjust the selection before calling cuemap_init.

cuemap_initA

Apply a user-confirmed repository ingestion scope and start CueMap's incremental filesystem watcher. Always call cuemap_init_preview first for a new repository and obtain explicit user confirmation before setting confirmed=true.

cuemap_addC

Store a natural-language memory in CueMap. Uses the repository-scoped default project unless one is supplied, creates it when needed, and applies deterministic cue extraction plus any cues and metadata.

cuemap_intent_classifyB

Classify text with CueMap's local intent model and return recall/memory eligibility signals. Scores are ranking signals, not calibrated probabilities.

cuemap_statusA

Check CueMap background ingestion progress for a project. After cuemap_init, poll this tool until verified_complete is true. An initial idle status with 0/0 writes is not proof that ingestion completed.

cuemap_projectsA

List CueMap projects, summary metadata, and whether each project is currently loaded in RAM.

cuemap_project_saveA

Persist the current state of a CueMap project without unloading it. Package operations save automatically; use this only when an explicit durable checkpoint is useful.

cuemap_project_loadA

Load a persisted CueMap project into RAM before a latency-sensitive operation. Normal project requests load automatically, so use this for explicit warm-up.

cuemap_project_unloadA

Persist and unload a CueMap project from RAM to reduce memory use. Use only when the user explicitly asks to unload or free inactive project memory; active projects return a retryable busy error.

cuemap_project_packA

Write a ready-to-query .cuemap package for one project to a local file. The package contains sensitive project content; use only after the user explicitly approves the exact output path.

cuemap_project_package_loadA

Install and warm a local .cuemap package. Use only after the user explicitly approves the exact package path; existing projects are never overwritten.

cuemap_project_pushA

Pack and upload a CueMap project with the engine host's configured AWS CLI. Use only after explicit approval of the exact S3 destination; an existing object at that URI may be replaced.

cuemap_project_pullA

Download, install, and warm a .cuemap package with the engine host's configured AWS CLI. Use only after explicit approval of the exact S3 source; existing projects are never overwritten.

cuemap_project_syncA

Fast-forward a project through immutable history at an S3 sync root. Pushes local-only changes, pulls remote-only changes, and refuses divergent histories or stale concurrent writes. Use only after explicit approval of the project and exact S3 root.

cuemap_statsB

Read CueMap statistics for the repository-scoped project or globally across the engine.

cuemap_memory_getA

Get one stored memory as readable text with source metadata. Pass the memory_id and owning project_id from recall as memory_id and project. Does not expand neighbors or read live source files.

cuemap_memory_reinforceC

Reinforce one CueMap memory, optionally along specific cue pathways.

cuemap_memory_deleteA

Permanently delete one CueMap memory. Set confirmed=true only after explicit user confirmation.

cuemap_ingest_urlA

Explicitly ingest content from a URL, optionally crawling same-domain links. Use only when the user asks to ingest that URL.

cuemap_ingest_contentB

Explicitly ingest supplied raw content into CueMap. Use only when the user asks to persist that content.

cuemap_ingest_fileA

Explicitly ingest one local file into CueMap. Use only for a file the user has placed in scope and asked to ingest.

cuemap_project_exportC

Export a cursor-paginated page of memories from a CueMap project.

cuemap_project_artifactsA

Inspect CueBridge artifact metadata for a CueMap project without reloading or mutating it.

cuemap_alias_listA

List manual cue aliases associated with one cue.

cuemap_alias_addB

Add a manual weighted mapping from one cue to another.

cuemap_alias_mergeB

Merge multiple cues into one canonical cue. Set confirmed=true only after explicit user confirmation.

cuemap_lexicon_inspectB

Inspect one cue and its Lexicon relationships.

cuemap_lexicon_graphB

Read the current Lexicon graph for a project.

cuemap_lexicon_wireC

Manually wire a token to a canonical Lexicon cue.

cuemap_lexicon_deleteA

Permanently delete one Lexicon entry. Set confirmed=true only after explicit user confirmation.

cuemap_recallA

Recall evidence for a focused question; follow up with narrower queries as needed. Returns engine JSON with project_id and memory_id handles, source metadata, and requested diagnostics in text and structuredContent. Use handles with cuemap_memory_get when the stored record is needed. Hybrid locally reranks lexical candidates. Start with a small limit and depth 1; enable reconstruction only when surrounding evidence is needed.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 31 tools

Disambiguation4/5

Most tools are clearly separated by resource type (project, memory, alias, lexicon, ingest) and action (init, add, get, delete, list, etc.). Some potential confusion exists between cuemap_project_artifacts and cuemap_project_export, and between cuemap_project_pack/package_load/push/pull/sync, but descriptions clarify their distinct purposes.

Naming Consistency4/5

Tool names consistently use the cuemap_ prefix with a resource domain (project, memory, alias, lexicon, ingest) followed by an action verb. Minor inconsistency: cuemap_project_package_load breaks the verb_noun pattern compared to cuemap_project_load, and cuemap_init_preview/cuemap_init are not resource-scoped like the others.

Tool Count3/5

31 tools is on the heavy side for a single MCP server, though the domain is broad (project lifecycle, memory operations, aliases, lexicon graph, ingestion, recall). The count is justified by the feature set but exceeds the typical well-scoped range.

Completeness4/5

The tool surface covers project lifecycle (init, load, unload, save, pack, push, pull, sync), memory CRUD (add, get, delete, reinforce), alias management, lexicon management, ingestion, and recall. Minor gaps: no explicit memory update tool and no project deletion tool, but the core workflows are well covered.