check_memory_status
Monitor the processing status of a memory by entering its ID. This tool ensures accurate tracking and retrieval of memory data within the Memory Box MCP Server.
Instructions
Check the processing status of a memory
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| memory_id | Yes | The ID of the memory to check status for |
Implementation Reference
- src/index.ts:1102-1131 (handler)Main execution handler for the 'check_memory_status' tool. Validates the memory_id argument, calls the MemoryBoxClient's getMemoryStatus method, formats the status information (processing_status, processed_at, attempts), and returns it as text content.case "check_memory_status": { // Validate parameters const memoryId = request.params.arguments?.memory_id; if (!memoryId) { throw new McpError(ErrorCode.InvalidParams, "Memory ID is required"); } // Get memory status const result = await memoryBoxClient.getMemoryStatus(Number(memoryId)); // Format the results let responseText = `Memory status for ID ${memoryId}:\n\n`; responseText += `Status: ${result.processing_status}\n`; if (result.processed_at) { responseText += `Processed at: ${result.processed_at}\n`; } if (result.attempts !== null && result.attempts !== undefined) { responseText += `Processing attempts: ${result.attempts}\n`; } return { content: [{ type: "text", text: responseText }] }; }
- src/index.ts:327-347 (helper)Core helper function in MemoryBoxClient class that performs the HTTP GET request to the Memory Box API endpoint /api/v2/memory/{memoryId}/status to retrieve the processing status of a specific memory, with proper error handling.async getMemoryStatus(memoryId: number): Promise<any> { try { const response = await axios.get( `${this.baseUrl}/api/v2/memory/${memoryId}/status`, { headers: { "Authorization": `Bearer ${this.token}` } } ); return response.data; } catch (error) { if (axios.isAxiosError(error)) { throw new McpError( ErrorCode.InternalError, `Failed to get memory status: ${error.response?.data?.detail || error.message}` ); } throw error; } }
- src/index.ts:750-763 (registration)Tool registration entry in the ListToolsRequestSchema handler, defining the tool name, description, and input schema (requiring memory_id as integer). This is returned when clients query available tools.{ name: "check_memory_status", description: "Check the processing status of a memory", inputSchema: { type: "object", properties: { memory_id: { type: "integer", description: "The ID of the memory to check status for" } }, required: ["memory_id"] } },
- src/index.ts:753-762 (schema)Input schema for the check_memory_status tool, defining the required memory_id parameter as an integer.inputSchema: { type: "object", properties: { memory_id: { type: "integer", description: "The ID of the memory to check status for" } }, required: ["memory_id"] }