@cachly-dev/mcp-server 0.9.8 → 0.9.9

package/dist/index.js

@@ -2452,15 +2452,20 @@ const TOOLS = [
     },
     {
         name: 'cache_delete',
-        description: 'Delete one or more keys from a running cache instance.',
+        description: 'Permanently delete one or more keys from a running cache instance (uses Redis DEL). ' +
+            'This operation is destructive and irreversible — deleted keys cannot be recovered. ' +
+            'Deleting a non-existent key is safe and returns 0 for that key (no error). ' +
+            'Returns the count of keys that were actually deleted (existing keys only). ' +
+            'Use this to explicitly remove stale entries; prefer cache_set with a short TTL for auto-expiring data. ' +
+            'Do NOT use this to clear an entire instance — use the dashboard or delete_instance for that.',
         inputSchema: {
             type: 'object',
             properties: {
-                instance_id: { type: 'string' },
+                instance_id: { type: 'string', description: 'UUID of the cache instance to delete keys from (get from list_instances)' },
                 keys: {
                     type: 'array',
                     items: { type: 'string' },
-                    description: 'One or more cache keys to delete',
+                    description: 'One or more cache keys to delete. Accepts exact keys only (no glob patterns — use cache_keys to list first).',
                 },
             },
             required: ['instance_id', 'keys'],
@@ -2468,12 +2473,17 @@ const TOOLS = [
     },
     {
         name: 'cache_exists',
-        description: 'Check whether one or more keys exist in the cache. Returns a count of existing keys.',
+        description: 'Check whether one or more keys exist in a running cache instance (uses Redis EXISTS). ' +
+            'Read-only — no side effects. Returns the count of keys that currently exist (integer 0 to N). ' +
+            'If none of the keys exist, returns 0. If all exist, returns the total key count passed in. ' +
+            'Duplicate keys in the input array are each counted separately (Redis behavior). ' +
+            'Use this to check presence before a cache_get to avoid null handling, or to verify a cache warm-up completed. ' +
+            'Use cache_get instead if you also need the value; use cache_ttl if you need expiry info.',
         inputSchema: {
             type: 'object',
             properties: {
-                instance_id: { type: 'string' },
-                keys: { type: 'array', items: { type: 'string' }, description: 'Keys to check' },
+                instance_id: { type: 'string', description: 'UUID of the cache instance to check (get from list_instances)' },
+                keys: { type: 'array', items: { type: 'string' }, description: 'Keys to check for existence. Accepts exact keys only (no glob patterns).' },
             },
             required: ['instance_id', 'keys'],
         },
@@ -3294,8 +3304,12 @@ const TOOLS = [
     },
     {
         name: 'global_recall',
-        description: 'Recall cross-project lessons stored via global_learn. ' +
-            'Returns all global lessons or those matching a topic filter.',
+        description: 'Read-only retrieval of cross-project lessons stored via global_learn. No side effects. ' +
+            'Returns a list of matching global lesson objects, each with topic, lesson text, severity, and tags. ' +
+            'If no topic is provided, returns all global lessons (up to 50). ' +
+            'If topic is provided, returns all lessons whose topic key contains that string (partial match). ' +
+            'Use this for lessons that apply universally across all projects (tool quirks, shell gotchas, platform behavior). ' +
+            'Use recall_best_solution instead for project-specific lessons; use team_recall for org-scoped lessons.',
         inputSchema: {
             type: 'object',
             properties: {