@cachly-dev/mcp-server 0.9.9 → 0.9.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cachly-dev/mcp-server",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "mcpName": "io.github.cachly-dev/cachly-mcp",
   "description": "Your AI forgets everything between sessions. cachly fixes that permanently. A causal brain that learns WHY things break — built from every bug fix, git commit, and CI run, without any explicit calls. Arrives pre-briefed each session. Predicts failures before they happen. Never re-researches the same problem. 63 MCP tools · Claude Code · Cursor · GitHub Copilot · Windsurf · Free tier · EU servers.",
   "type": "module",

package/src/index.ts

@@ -2408,7 +2408,13 @@ const TOOLS = [
   // ── Instance Management ──────────────────────────────────────────────────
   {
     name: 'list_instances',
-    description: 'List all your cachly cache instances with their status and connection details.',
+    description:
+      'List all your cachly cache instances with their status and connection details. ' +
+      'Read-only. Returns an array of instance objects — each with id, name, tier, status, region, RAM, ' +
+      'and redis:// connection string. Returns an empty array if no instances exist. ' +
+      'No pagination: all instances are returned in one call (typical accounts have < 20). ' +
+      'Use this first to discover instance UUIDs required by get_instance, cache_get, cache_set, ' +
+      'and all other cache tools. Use get_instance to retrieve full metadata for a single instance.',
     inputSchema: { type: 'object', properties: {}, required: [] },
   },
   {
@@ -2433,7 +2439,12 @@ const TOOLS = [
   },
   {
     name: 'get_instance',
-    description: 'Get details and the Redis connection string for a specific cache instance.',
+    description:
+      'Get full metadata for a specific cache instance: name, tier, status (provisioning / running / paused), ' +
+      'region, RAM limit, Redis connection string, created_at, and expiry. Read-only. ' +
+      'Returns an error if the instance_id is not found or belongs to another account. ' +
+      'Call list_instances first to discover valid UUIDs. ' +
+      'Use get_connection_string instead if you only need the redis:// URL for your app config.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -2572,11 +2583,15 @@ const TOOLS = [
     name: 'cache_stats',
     description:
       'Get real-time stats for a cache instance: memory usage, hit/miss rate, commands/sec, ' +
-      'connected clients, keyspace info, and uptime.',
+      'connected clients, keyspace info, and uptime. Read-only — no side effects. ' +
+      'The instance_id identifies the target instance (obtain from list_instances). ' +
+      'Use this for monitoring, capacity planning, or debugging performance issues — ' +
+      'not for reading cached values (use cache_get for that). ' +
+      'Use cache_exists or cache_ttl if you only need key-level information.',
     inputSchema: {
       type: 'object',
       properties: {
-        instance_id: { type: 'string' },
+        instance_id: { type: 'string', description: 'UUID of the cache instance (from list_instances)' },
       },
       required: ['instance_id'],
     },
@@ -3432,8 +3447,12 @@ const TOOLS = [
     name: 'import_public_brain',
     description:
       'Import community lessons from the Cachly Public Brain for a framework. ' +
-      'Loads battle-tested, community-curated lessons into your brain instance. ' +
-      'Available: nextjs, fastapi, go, docker, kubernetes, react, typescript, python, rust, laravel, rails, spring.',
+      'Non-destructive: existing lessons with the same topic key are not overwritten. ' +
+      'Returns the count of lessons imported and their topic slugs. ' +
+      'Available frameworks: nextjs, fastapi, go, docker, kubernetes, react, typescript, python, rust, laravel, rails, spring. ' +
+      'Use this to bootstrap a new brain with battle-tested community knowledge before your first session_start. ' +
+      'Use publish_lesson to contribute your own lessons to the Public Brain; ' +
+      'use learn_from_attempts for storing lessons from your own sessions.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -3653,12 +3672,16 @@ const TOOLS = [
   {
     name: 'causal_trace',
     description:
-      'Root Cause Analysis through memory — the most powerful debugging tool in your AI Brain. ' +
-      'Given a problem description, traces the causal chain from root cause through intermediate ' +
-      'failures to the current symptom, then surfaces the exact solution that worked before. ' +
+      'Root Cause Analysis through memory: given a problem description, traces the causal chain ' +
+      'from root cause through intermediate failures to the current symptom, then surfaces the ' +
+      'exact solution that worked before. Read-only — does not modify any stored data. ' +
+      'Requires prior learning: brain must have lessons stored via learn_from_attempts or brain_from_git. ' +
+      'Returns an ordered chain of concepts with confidence scores plus the matching solution; ' +
+      'returns an empty chain with a message if no causal path is found. ' +
       'Example: causal_trace(problem="auth breaks after restart") → ' +
-      '"Root: k8s:namespace-terminating → keycloak:jwks-race → Solution from March 12: PollUntilContextTimeout 3min" ' +
-      'No other memory system can do this. Replaces 30 minutes of git blame + log archaeology.',
+      '"Root: k8s:namespace-terminating → keycloak:jwks-race → Solution: PollUntilContextTimeout 3min". ' +
+      'Use recall_best_solution for direct topic lookup, syndicate_search for community patterns, ' +
+      'and causal_trace when you have a symptom and need the full root-cause chain.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -3691,12 +3714,16 @@ const TOOLS = [
   {
     name: 'autopilot',
     description:
-      'The endgame: generate a CLAUDE.md / copilot-instructions.md that turns any AI into a ' +
-      'self-managing brain operator. Zero manual session_start / session_end calls forever. ' +
-      'The generated file instructs Claude, Cursor, Copilot, Windsurf, or Gemini to ' +
-      'automatically call session_start at window open, learn_from_attempts after every fix, ' +
-      'and session_end before closing — without being asked. ' +
-      'One command. Every AI. Always on.',
+      'Generate a CLAUDE.md / copilot-instructions.md that makes any AI self-managing forever. ' +
+      'Writes a configuration file to disk — will overwrite an existing file at the target path. ' +
+      'No auth required beyond a valid instance_id. ' +
+      'The generated file instructs Claude, Cursor, Copilot, Windsurf, or Gemini to automatically ' +
+      'call session_start at window open, learn_from_attempts after every fix, and session_end ' +
+      'before closing — without being asked. ' +
+      'Returns the generated file content as a string and the path where it was written. ' +
+      'Use style="minimal" for just the three hooks; style="full" for the complete ruleset with examples. ' +
+      'One command. Every AI. Always on. ' +
+      'Use setup_ai_memory instead if you want an interactive one-shot setup that also creates an instance.',
     inputSchema: {
       type: 'object',
       properties: {