CueMap MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CUEMAP_URL | No | If 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_PORT | No | Override the port the embedded engine binds to (default: 8735). | 8735 |
| CUEMAP_PROJECT | No | Override the default project. Without this setting, CueMap derives a stable repository-scoped project from the current Git remote or working directory. | |
| CUEMAP_LOG_PATH | No | Override the embedded engine log path. It defaults to ~/.cuemap/server.log, which is the file read by cuemap logs. | |
| CUEMAP_CONFIG_PATH | No | Absolute 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 31 tools
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.
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.
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.
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.