Memlord

recall_memory

Read-only

Search memories by time expression + semantics. Returns names + metadata only.

Examples: "last week", "yesterday", "about Python last month". Use get_memory(name=...) to fetch full content of a specific result. Pass workspace= to search only within a specific workspace.

Input Schema

TableJSON Schema

Name	Required	Description
`query`	Yes	Query string
`n_results`	No
`workspace`	No
`memory_type`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`items`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed12 schema fields changedSep 27, 2026

changedInput schema / properties / memory_type / anyOf

Previous value: -[
-  {
-    "description": "fact: established fact about user, project, or system.\npreference: user's likes, dislikes, habits.\ninstruction: persistent rule Claude must follow.\nfeedback: evaluation of Claude's output.\ndecision: a choice made with reasoning ('chose X over Y because Z').",
-    "enum": [
-      "fact",
-      "preference",
-      "instruction",
-      "feedback",
-      "decision"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "description": "fact: established fact about user, project, or system.\npreference: user's likes, dislikes, habits.\ninstruction: persistent rule Claude must follow.\nfeedback: evaluation of Claude's output.\ndecision: a choice made with reasoning ('chose X over Y because Z').\ninsight: consolidated conclusion distilled from several existing memories.",
+    "enum": [
+      "fact",
+      "preference",
+      "instruction",
+      "feedback",
+      "decision",
+      "insight"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / n_results / minimum
```
Added value: +1
```
addedInput schema / properties / query / description
```
Added value: +"Query string"
```

addedInput schema / properties / query / examples

Added value: +[
+  "last week",
+  "yesterday",
+  "about Python last month"
+]

removedInput schema / properties / snippet_length

Removed value: -{
-  "default": 200,
-  "type": "integer"
-}

removedOutput schema / properties / items / items / properties / content
```
Removed value: -{
-  "title": "Content",
-  "type": "string"
-}
```
removedOutput schema / properties / items / items / properties / id
```
Removed value: -{
-  "title": "Id",
-  "type": "integer"
-}
```

changedOutput schema / properties / items / items / properties / memory_type / anyOf

Previous value: -[
-  {
-    "description": "fact: established fact about user, project, or system.\npreference: user's likes, dislikes, habits.\ninstruction: persistent rule Claude must follow.\nfeedback: evaluation of Claude's output.\ndecision: a choice made with reasoning ('chose X over Y because Z').",
-    "enum": [
-      "fact",
-      "preference",
-      "instruction",
-      "feedback",
-      "decision"
-    ],
-    "title": "MemoryType",
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "description": "fact: established fact about user, project, or system.\npreference: user's likes, dislikes, habits.\ninstruction: persistent rule Claude must follow.\nfeedback: evaluation of Claude's output.\ndecision: a choice made with reasoning ('chose X over Y because Z').\ninsight: consolidated conclusion distilled from several existing memories.",
+    "enum": [
+      "fact",
+      "preference",
+      "instruction",
+      "feedback",
+      "decision",
+      "insight"
+    ],
+    "title": "MemoryType",
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / items / items / properties / name
```
Added value: +{
+  "title": "Name",
+  "type": "string"
+}
```

addedOutput schema / properties / items / items / properties / workspace

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Workspace"
+}

removedOutput schema / properties / items / items / properties / workspace_id

Removed value: -{
-  "anyOf": [
-    {
-      "type": "integer"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "title": "Workspace Id"
-}

changedOutput schema / properties / items / items / required

Previous value: -[
-  "id",
-  "content",
-  "memory_type",
-  "tags",
-  "created_at"
-]New value: +[
+  "name",
+  "memory_type",
+  "tags",
+  "created_at"
+]

Changed8 schema fields changedApr 8, 2026

changedInput schema / properties / memory_type / anyOf

Previous value: -[
-  {
-    "enum": [
-      "fact",
-      "preference",
-      "instruction",
-      "feedback"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "description": "fact: established fact about user, project, or system.\npreference: user's likes, dislikes, habits.\ninstruction: persistent rule Claude must follow.\nfeedback: evaluation of Claude's output.\ndecision: a choice made with reasoning ('chose X over Y because Z').",
+    "enum": [
+      "fact",
+      "preference",
+      "instruction",
+      "feedback",
+      "decision"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / snippet_length / anyOf

Removed value: -[
-  {
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / snippet_length / type
```
Added value: +"integer"
```

addedOutput schema / properties / items

Added value: +{
+  "items": {
+    "properties": {
+      "content": {
+        "title": "Content",
+        "type": "string"
+      },
+      "created_at": {
+        "format": "date-time",
+        "title": "Created At",
+        "type": "string"
+      },
+      "id": {
+        "title": "Id",
+        "type": "integer"
+      },
+      "memory_type": {
+        "anyOf": [
+          {
+            "description": "fact: established fact about user, project, or system.\npreference: user's likes, dislikes, habits.\ninstruction: persistent rule Claude must follow.\nfeedback: evaluation of Claude's output.\ndecision: a choice made with reasoning ('chose X over Y because Z').",
+            "enum": [
+              "fact",
+              "preference",
+              "instruction",
+              "feedback",
+              "decision"
+            ],
+            "title": "MemoryType",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "tags": {
+        "items": {
+          "type": "string"
+        },
+        "title": "Tags",
+        "type": "array",
+        "uniqueItems": true
+      },
+      "workspace_id": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Workspace Id"
+      }
+    },
+    "required": [
+      "id",
+      "content",
+      "memory_type",
+      "tags",
+      "created_at"
+    ],
+    "title": "RecallResult",
+    "type": "object"
+  },
+  "title": "Items",
+  "type": "array"
+}

removedOutput schema / properties / result

Removed value: -{
-  "items": {
-    "properties": {
-      "content": {
-        "type": "string"
-      },
-      "created_at": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "id": {
-        "type": "integer"
-      },
-      "memory_type": {
-        "anyOf": [
-          {
-            "enum": [
-              "fact",
-              "preference",
-              "instruction",
-              "feedback"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "tags": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array",
-        "uniqueItems": true
-      },
-      "workspace_id": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      }
-    },
-    "required": [
-      "id",
-      "content",
-      "memory_type",
-      "tags",
-      "created_at"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

removedOutput schema / required
```
Removed value: -[
-  "result"
-]
```
addedOutput schema / title
```
Added value: +"RecallPage"
```
removedOutput schema / x-fastmcp-wrap-result
```
Removed value: -true
```

First observedApr 1, 2026

TDQS

A3.8/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and destructiveHint=false, so the safety profile is covered. The description adds one useful behavioral fact – results are truncated to names and metadata rather than full records. It says nothing about result counts, ranking, or pagination beyond that, and an output schema already exists, so a 3 is appropriate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four tight lines: capability plus output contract first, then examples, then the escape hatch to get_memory, then the workspace scoping note. Every sentence carries distinct information and nothing is repeated from the schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present and annotations covering the safety profile, the description only needs to cover invocation semantics, which it largely does via query format examples, the result-truncation contract, and the get_memory follow-up. The unexplained n_results parameter is the one remaining gap for a search tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 25%, so the description must compensate, and it partially does: it explains the query accepts time expressions plus semantics and gives three concrete examples, and it explains the workspace scope parameter. It says nothing about n_results or memory_type, leaving two of four parameters to the schema alone.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a specific verb and resource (search memories) and narrows scope to time expression + semantics, plus an explicit output boundary (names + metadata only). That output boundary meaningfully separates it from get_memory, which fetches full content. It does not clearly separate itself from the sibling retrieve_memory, which keeps it short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives a concrete follow-up path (use get_memory(name=...) for full content) and a scoping rule (pass workspace=<name> to restrict the search), which tells the agent when to reach for this tool. It lacks explicit exclusions relative to retrieve_memory and list_memories, so it is clear context rather than full when/when-not guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Memlord tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?