mcp-toolz

Instructions

Implementation Reference

• src/mcp_server/server.py:474-480 (handler)

  Handler logic for the todo_get tool: retrieves todo snapshot by ID from storage, handles not found case, formats and returns the details.

  if name == "todo_get":
      snapshot_id = arguments["snapshot_id"]
      snapshot = self.storage.get_todo_snapshot(snapshot_id)
      if not snapshot:
          return [TextContent(type="text", text=f"Todo snapshot {snapshot_id} not found")]
      result = self._format_todo_snapshot_detail(snapshot)
      return [TextContent(type="text", text=result)]

• src/mcp_server/server.py:221-231 (schema)

  Schema definition and registration of the todo_get tool in the list_tools method, including input schema requiring snapshot_id.

  Tool(
      name="todo_get",
      description="Get full details of a specific todo snapshot by ID",
      inputSchema={
          "type": "object",
          "properties": {
              "snapshot_id": {"type": "string", "description": "Todo snapshot ID"},
          },
          "required": ["snapshot_id"],
      },
  ),

• src/mcp_server/server.py:711-737 (helper)

  Helper function used by todo_get to format the todo snapshot details into a readable string response.

  def _format_todo_snapshot_detail(self, snapshot: Any) -> str:
      """Format a single todo snapshot with full details."""
      from models import TodoListSnapshot
  
      if not isinstance(snapshot, TodoListSnapshot):
          return "Invalid snapshot"
  
      lines = [
          f"Snapshot ID: {snapshot.id}",
          f"Timestamp: {snapshot.timestamp.isoformat()}",
          f"Project: {snapshot.project_path}",
          f"Active: {'Yes' if snapshot.is_active else 'No'}",
      ]
  
      if snapshot.context:
          lines.append(f"Context: {snapshot.context}")
  
      if snapshot.session_context_id:
          lines.append(f"Linked Context ID: {snapshot.session_context_id}")
  
      lines.append("\n## Todo Items\n")
  
      for i, todo in enumerate(snapshot.todos, 1):
          status_icon = {"pending": "○", "in_progress": "⟳", "completed": "✓"}.get(todo.status, "○")
          lines.append(f"{i}. {status_icon} [{todo.status}] {todo.content}")
  
      return "\n".join(lines)