@prmichaelsen/remember-mcp 2.1.0 → 2.2.1

package/dist/server-factory.js

@@ -1433,6 +1433,8 @@ var searchMemoryTool = {
   name: "remember_search_memory",
   description: `Search memories AND relationships using hybrid semantic and keyword search.
   
+  **BEST FOR**: Precise searches with specific keywords or exact phrases. Good for finding specific items when you know what you're looking for.
+  
   By default, searches BOTH memories and relationships to provide comprehensive results.
   Relationships contain valuable context in their observations.
   
@@ -1447,6 +1449,15 @@ var searchMemoryTool = {
   - "Find memories about camping trips" \u2192 returns memories + relationships about camping
   - "Search for recipes I saved" \u2192 returns recipe memories + related relationships
   - "Show me notes from last week" \u2192 returns notes + any relationships created that week
+  
+  **AGENT GUIDANCE**:
+  - If search results are too narrow or miss relevant content, try remember_query_memory instead - it uses pure semantic search which is better for broader, concept-based queries. You can inform the user: "I didn't find what you're looking for with keyword search. Let me try a broader semantic search using the query tool."
+  - **CRITICAL**: If no results are returned, DO NOT make up or fabricate memories. Only report what was actually found. Tell the user honestly that no matching memories were found and suggest they:
+    * Create a new memory with the information they're looking for
+    * Try the other search tool (remember_query_memory for broader semantic search)
+    * Remove or relax filters if they applied any
+    * Increase the limit parameter to see more results
+    * Try different search terms or keywords
   `,
   inputSchema: {
     type: "object",
@@ -1987,6 +1998,8 @@ var queryMemoryTool = {
   name: "remember_query_memory",
   description: `Query memories using natural language for RAG (Retrieval-Augmented Generation).
   
+  **BEST FOR**: Broad, concept-based searches and natural language questions. Uses pure semantic search to find memories by meaning, not just keywords. Great for exploratory queries and when you're not sure of exact terms.
+  
   This tool is optimized for LLM context retrieval. It returns relevant memories
   with their full content and context, formatted for easy consumption by LLMs.
   
@@ -1995,12 +2008,23 @@ var queryMemoryTool = {
   - Provide context for conversations
   - Retrieve information for decision-making
   - Build responses using past knowledge
+  - Find memories by concept rather than exact keywords
   
   Examples:
   - "What do I know about camping?"
   - "Tell me about the recipes I've saved"
   - "What meetings did I have last week?"
   - "What are my project goals?"
+  
+  **AGENT GUIDANCE**:
+  - If query results are too broad or include irrelevant content, try remember_search_memory instead - it uses hybrid search with keyword matching which is better for precise, specific searches. You can inform the user: "The results were too broad. Let me try a more precise keyword search using the search tool."
+  - **CRITICAL**: If no results are returned, DO NOT make up or fabricate memories. Only report what was actually found. Tell the user honestly that no matching memories were found and suggest they:
+    * Create a new memory with the information they're looking for
+    * Try the other search tool (remember_search_memory for more precise keyword-based search)
+    * Remove or relax filters if they applied any
+    * Increase the limit parameter to see more results
+    * Lower the min_relevance threshold to include less relevant matches
+    * Try rephrasing the query with different terms
   `,
   inputSchema: {
     type: "object",

package/dist/server.js

@@ -1475,6 +1475,8 @@ var searchMemoryTool = {
   name: "remember_search_memory",
   description: `Search memories AND relationships using hybrid semantic and keyword search.
   
+  **BEST FOR**: Precise searches with specific keywords or exact phrases. Good for finding specific items when you know what you're looking for.
+  
   By default, searches BOTH memories and relationships to provide comprehensive results.
   Relationships contain valuable context in their observations.
   
@@ -1489,6 +1491,15 @@ var searchMemoryTool = {
   - "Find memories about camping trips" \u2192 returns memories + relationships about camping
   - "Search for recipes I saved" \u2192 returns recipe memories + related relationships
   - "Show me notes from last week" \u2192 returns notes + any relationships created that week
+  
+  **AGENT GUIDANCE**:
+  - If search results are too narrow or miss relevant content, try remember_query_memory instead - it uses pure semantic search which is better for broader, concept-based queries. You can inform the user: "I didn't find what you're looking for with keyword search. Let me try a broader semantic search using the query tool."
+  - **CRITICAL**: If no results are returned, DO NOT make up or fabricate memories. Only report what was actually found. Tell the user honestly that no matching memories were found and suggest they:
+    * Create a new memory with the information they're looking for
+    * Try the other search tool (remember_query_memory for broader semantic search)
+    * Remove or relax filters if they applied any
+    * Increase the limit parameter to see more results
+    * Try different search terms or keywords
   `,
   inputSchema: {
     type: "object",
@@ -2029,6 +2040,8 @@ var queryMemoryTool = {
   name: "remember_query_memory",
   description: `Query memories using natural language for RAG (Retrieval-Augmented Generation).
   
+  **BEST FOR**: Broad, concept-based searches and natural language questions. Uses pure semantic search to find memories by meaning, not just keywords. Great for exploratory queries and when you're not sure of exact terms.
+  
   This tool is optimized for LLM context retrieval. It returns relevant memories
   with their full content and context, formatted for easy consumption by LLMs.
   
@@ -2037,12 +2050,23 @@ var queryMemoryTool = {
   - Provide context for conversations
   - Retrieve information for decision-making
   - Build responses using past knowledge
+  - Find memories by concept rather than exact keywords
   
   Examples:
   - "What do I know about camping?"
   - "Tell me about the recipes I've saved"
   - "What meetings did I have last week?"
   - "What are my project goals?"
+  
+  **AGENT GUIDANCE**:
+  - If query results are too broad or include irrelevant content, try remember_search_memory instead - it uses hybrid search with keyword matching which is better for precise, specific searches. You can inform the user: "The results were too broad. Let me try a more precise keyword search using the search tool."
+  - **CRITICAL**: If no results are returned, DO NOT make up or fabricate memories. Only report what was actually found. Tell the user honestly that no matching memories were found and suggest they:
+    * Create a new memory with the information they're looking for
+    * Try the other search tool (remember_search_memory for more precise keyword-based search)
+    * Remove or relax filters if they applied any
+    * Increase the limit parameter to see more results
+    * Lower the min_relevance threshold to include less relevant matches
+    * Try rephrasing the query with different terms
   `,
   inputSchema: {
     type: "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prmichaelsen/remember-mcp",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "Multi-tenant memory system MCP server with vector search and relationships",
   "main": "dist/server.js",
   "type": "module",

package/src/tools/query-memory.ts

@@ -16,6 +16,8 @@ export const queryMemoryTool = {
   name: 'remember_query_memory',
   description: `Query memories using natural language for RAG (Retrieval-Augmented Generation).
   
+  **BEST FOR**: Broad, concept-based searches and natural language questions. Uses pure semantic search to find memories by meaning, not just keywords. Great for exploratory queries and when you're not sure of exact terms.
+  
   This tool is optimized for LLM context retrieval. It returns relevant memories
   with their full content and context, formatted for easy consumption by LLMs.
   
@@ -24,12 +26,23 @@ export const queryMemoryTool = {
   - Provide context for conversations
   - Retrieve information for decision-making
   - Build responses using past knowledge
+  - Find memories by concept rather than exact keywords
   
   Examples:
   - "What do I know about camping?"
   - "Tell me about the recipes I've saved"
   - "What meetings did I have last week?"
   - "What are my project goals?"
+  
+  **AGENT GUIDANCE**:
+  - If query results are too broad or include irrelevant content, try remember_search_memory instead - it uses hybrid search with keyword matching which is better for precise, specific searches. You can inform the user: "The results were too broad. Let me try a more precise keyword search using the search tool."
+  - **CRITICAL**: If no results are returned, DO NOT make up or fabricate memories. Only report what was actually found. Tell the user honestly that no matching memories were found and suggest they:
+    * Create a new memory with the information they're looking for
+    * Try the other search tool (remember_search_memory for more precise keyword-based search)
+    * Remove or relax filters if they applied any
+    * Increase the limit parameter to see more results
+    * Lower the min_relevance threshold to include less relevant matches
+    * Try rephrasing the query with different terms
   `,
   inputSchema: {
     type: 'object',

package/src/tools/search-memory.ts

@@ -16,6 +16,8 @@ export const searchMemoryTool = {
   name: 'remember_search_memory',
   description: `Search memories AND relationships using hybrid semantic and keyword search.
   
+  **BEST FOR**: Precise searches with specific keywords or exact phrases. Good for finding specific items when you know what you're looking for.
+  
   By default, searches BOTH memories and relationships to provide comprehensive results.
   Relationships contain valuable context in their observations.
   
@@ -30,6 +32,15 @@ export const searchMemoryTool = {
   - "Find memories about camping trips" → returns memories + relationships about camping
   - "Search for recipes I saved" → returns recipe memories + related relationships
   - "Show me notes from last week" → returns notes + any relationships created that week
+  
+  **AGENT GUIDANCE**:
+  - If search results are too narrow or miss relevant content, try remember_query_memory instead - it uses pure semantic search which is better for broader, concept-based queries. You can inform the user: "I didn't find what you're looking for with keyword search. Let me try a broader semantic search using the query tool."
+  - **CRITICAL**: If no results are returned, DO NOT make up or fabricate memories. Only report what was actually found. Tell the user honestly that no matching memories were found and suggest they:
+    * Create a new memory with the information they're looking for
+    * Try the other search tool (remember_query_memory for broader semantic search)
+    * Remove or relax filters if they applied any
+    * Increase the limit parameter to see more results
+    * Try different search terms or keywords
   `,
   inputSchema: {
     type: 'object',