get_short_term_memory

Retrieve session-specific data from temporary memory storage to maintain context and continuity in AI interactions.

Instructions

Retrieve data from short-term memory

Input Schema

TableJSON Schema

Name	Required	Description	Default
`key`	No	Memory key (optional, returns all if not provided)
`sessionId`	Yes	Session identifier

Implementation Reference

src/handlers/ToolHandlers.ts:210-226 (handler)

MCP tool handler execution logic: validates sessionId and optional key, retrieves short-term memory from store, returns as formatted JSON text response.

case "get_short_term_memory": {
  const { sessionId, key } = request.params.arguments as any;
  
  // Validate inputs
  ValidationUtils.validateSessionId(sessionId);
  if (key !== undefined) {
    ValidationUtils.validateMemoryKey(key);
  }
  
  const memory = memoryStore.getShortTermMemory(sessionId, key);
  return {
    content: [{
      type: "text",
      text: JSON.stringify(memory, null, 2)
    }]
  };
}

src/handlers/ToolHandlers.ts:51-63 (schema)

Input schema definition for the get_short_term_memory tool, specifying sessionId as required and key as optional.

inputSchema: {
  type: "object",
  properties: {
    sessionId: {
      type: "string",
      description: "Session identifier"
    },
    key: {
      type: "string",
      description: "Memory key (optional, returns all if not provided)"
    }
  },
  required: ["sessionId"]

src/handlers/ToolHandlers.ts:48-65 (registration)

Tool registration in the list of available tools, including name, description, and input schema.

{
  name: "get_short_term_memory",
  description: "Retrieve data from short-term memory",
  inputSchema: {
    type: "object",
    properties: {
      sessionId: {
        type: "string",
        description: "Session identifier"
      },
      key: {
        type: "string",
        description: "Memory key (optional, returns all if not provided)"
      }
    },
    required: ["sessionId"]
  }
},

src/store/MemoryStore.ts:104-111 (helper)

Core implementation of short-term memory retrieval: fetches from in-memory map, checks expiration and cleans up if expired, returns specific key or entire session data.

getShortTermMemory(sessionId: string, key?: string): any {
  const memory = this.shortTermMemory.get(sessionId);
  if (!memory || memory.expiresAt <= Date.now()) {
    this.shortTermMemory.delete(sessionId);
    return null;
  }
  return key ? memory.data[key] : memory.data;
}

Memory MCP Server