{"serverId":"mcp-registry/io.github.cachly-dev/mcp-server","tools":[{"name":"brain_search","fixed":{"name":"brain_search","description":"BM25+ full-text search over ALL brain data: lessons, context entries, session history, CKG nodes, roadmap items. Unlike smart_recall (which focuses on lessons + context), brain_search casts a wider net. Use when smart_recall returns nothing or when you want to find anything the brain knows about a topic.","inputSchema":{"type":"object","required":["query"],"properties":{"limit":{"type":"number","description":"Max results (default: 15)"},"query":{"type":"string","description":"What to search for"},"instance_id":{"type":"string","description":"Brain instance ID"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":169,"tokensAfter":169},{"name":"cache_get","fixed":{"name":"cache_get","description":"Get a value from a running cache instance by key. Returns the stored value (string or deserialized JSON object) or null if the key does not exist or has expired. Read-only — no side effects. Use cache_mget when you need multiple keys in one round-trip. Use cache_exists to check existence without retrieving the value. Use semantic_search when you need fuzzy/vector search across stored values.","inputSchema":{"type":"object","required":["key"],"properties":{"key":{"type":"string","description":"Cache key to retrieve"},"org_id":{"type":"string","description":"Optional org ID — if the direct key misses, falls back to the shared org namespace org:{org_id}:sem:{key}"},"instance_id":{"type":"string","description":"UUID of the instance."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":217,"tokensAfter":217},{"name":"cache_set","fixed":{"name":"cache_set","description":"Set a key-value pair in a running cache instance. Overwrites any existing value at the key — not idempotent for new data. Returns \"OK\" on success; returns an error if the instance_id is invalid or the instance is paused. Value can be a string or a JSON-serialized object. Optionally set a TTL in seconds (omit for no expiry). Use cache_mset instead for setting multiple keys in a single pipeline round-trip. Use cache_stream_set instead for caching LLM token streams (ordered string chunks).","inputSchema":{"type":"object","required":["key","value"],"properties":{"key":{"type":"string","description":"Cache key"},"ttl":{"type":"number","description":"Time-to-live in seconds (optional, omit for no expiry)"},"value":{"type":"string","description":"Value to store (string or JSON)"},"org_id":{"type":"string","description":"Optional org ID — also writes the key to the shared org namespace org:{org_id}:sem:{key} with the same TTL"},"instance_id":{"type":"string","description":"UUID of the cache instance (from list_instances)"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":298,"tokensAfter":298},{"name":"list_remembered","fixed":{"name":"list_remembered","description":"List all cached context entries for this project. Shows what knowledge the AI assistant has already cached, so you can decide whether to recall existing context or refresh it. Returns: key, category, size, TTL remaining, and a content preview.","inputSchema":{"type":"object","required":[],"properties":{"limit":{"type":"number","description":"Max entries to return (default: 50)"},"category":{"enum":["overview","architecture","file_summary","dependency","thinking","custom","all"],"type":"string","description":"Filter by category (default: all)"},"instance_id":{"type":"string","description":"UUID of the cache instance."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":186,"tokensAfter":186},{"name":"roadmap_add","fixed":{"name":"roadmap_add","description":"Add a new item to the persistent project roadmap stored in the Brain. Items survive across sessions and editors — the roadmap is always up to date. Use for features, bugs, refactors, or any planned work. Call roadmap_list to see all open items, roadmap_next to get the next actionable item.","inputSchema":{"type":"object","required":["title"],"properties":{"tags":{"type":"array","items":{"type":"string"},"description":"Tags for filtering (e.g. [\"api\", \"web\", \"sdk\", \"infra\"])"},"title":{"type":"string","description":"Short title of the task/feature (3–10 words)"},"priority":{"enum":["critical","high","medium","low"],"type":"string","description":"Priority level (default: medium)"},"milestone":{"type":"string","description":"Milestone/epic this belongs to (optional)"},"description":{"type":"string","description":"What needs to be done, acceptance criteria, context"},"instance_id":{"type":"string","description":"UUID of the cache instance."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":278,"tokensAfter":278},{"name":"roadmap_list","fixed":{"name":"roadmap_list","description":"List all roadmap items, optionally filtered by status, priority, tag, or milestone. Returns items sorted by priority then creation date. Called automatically by session_start to show open work.","inputSchema":{"type":"object","required":[],"properties":{"tag":{"type":"string","description":"Filter by tag (optional)"},"status":{"enum":["planned","in-progress","done","blocked","cancelled","open"],"type":"string","description":"Filter by status. Use 'open' to see planned+in-progress+blocked (default: open)"},"priority":{"enum":["critical","high","medium","low"],"type":"string","description":"Filter by minimum priority (optional)"},"milestone":{"type":"string","description":"Filter by milestone (optional)"},"instance_id":{"type":"string","description":"UUID of the cache instance."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":231,"tokensAfter":231},{"name":"roadmap_update","fixed":{"name":"roadmap_update","description":"Update the status, priority, or details of a roadmap item. Use to move items through the lifecycle: planned → in-progress → done (or blocked/cancelled). Also use to add notes/findings while working on an item.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Item ID returned by roadmap_add or roadmap_list"},"notes":{"type":"string","description":"Progress notes, findings, or blockers (appended to existing notes)"},"title":{"type":"string","description":"Updated title (optional)"},"status":{"enum":["planned","in-progress","done","blocked","cancelled"],"type":"string","description":"New status for the item"},"priority":{"enum":["critical","high","medium","low"],"type":"string","description":"Updated priority (optional)"},"description":{"type":"string","description":"Updated description (optional)"},"instance_id":{"type":"string","description":"UUID of the cache instance."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":272,"tokensAfter":272},{"name":"semantic_search","fixed":{"name":"semantic_search","description":"Find cached entries that are semantically similar to a natural-language query. Read-only — no side effects. Returns an array of objects, each with: key, value, similarity_score (0–1), and namespace. Returns an empty array if no entries meet the similarity threshold. Requires OPENAI_API_KEY (or compatible provider) and CACHLY_VECTOR_URL; every tier includes a vector token. Embeddings are computed server-side and never leave Germany (pgvector HNSW index). Example: \"find all cached responses about ","inputSchema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Natural-language query to find similar cached content"},"top_k":{"type":"number","description":"Maximum number of results to return (default: 5)"},"namespace":{"type":"string","description":"Semantic namespace to search in (default: cachly:sem)"},"threshold":{"type":"number","description":"Minimum cosine similarity 0–1 (default: 0.82). Lower = broader matches."},"use_hybrid":{"type":"boolean","description":"Enable Hybrid BM25+Vector RRF fusion search. Passes `hybrid: true` and the query text to the pgvector API for higher precision on named entities. Default: false."},"instance_id":{"type":"string","description":"UUID of the cache instance (from list_instances)"},"auto_namespace":{"type":"boolean","description":"Auto-detect the namespace from the query text using text heuristics instead of using the `namespace` parameter. Returns results only from the matching domain (code/translation/summary/qa/creative)."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":438,"tokensAfter":438},{"name":"session_start","fixed":{"name":"session_start","description":"Single-call session briefing for the START of a session: last summary, recent lessons, health. It does not replace smart_recall for a concrete task. Returns: last session summary, recent lessons sorted by recency, relevant lessons for your focus area, brain health stats (counts of open failures and stale lessons), team telepathy (what teammates learned this week), predictive pre-warnings (if your focus area has known failure patterns), and memory crystals (compressed wisdom from old sessions). A","inputSchema":{"type":"object","required":[],"properties":{"focus":{"type":"string","description":"Keywords for what you plan to work on today (e.g. \"deploy infra api\"). Used to surface relevant lessons at the top."},"author":{"type":"string","description":"Your name or handle (e.g. \"alice\"). Enables Team Telepathy — filters YOUR lessons vs TEAM lessons from past 7 days."},"provider":{"type":"string","description":"Current AI provider (e.g. \"claude-code\", \"copilot\", \"cursor\", \"windsurf\"). Shown in the briefing header and saved so the next provider can see who was last active."},"instance_id":{"type":"string","description":"UUID of the cache instance."},"workspace_path":{"type":"string","description":"Absolute path to the project root. If no session_end was found (e.g. context limit hit), reads git log to reconstruct what happened since last session."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":395,"tokensAfter":395}],"toolsChanged":9,"tokensSaved":0,"todo":[],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}