Saga MCP

Instructions

Implementation Reference

• src/tools/comments.ts:57-64 (handler)

  The handler function that retrieves comments for a specific task from the database.

  function handleCommentList(args: Record<string, unknown>) {
    const db = getDb();
    const taskId = args.task_id as number;
  
    return db
      .prepare('SELECT * FROM comments WHERE task_id = ? ORDER BY created_at ASC')
      .all(taskId);
  }

• src/tools/comments.ts:22-33 (schema)

  The definition and schema for the 'comment_list' tool.

  {
    name: 'comment_list',
    description: 'List all comments on a task in chronological order.',
    annotations: { title: 'List Comments', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
    inputSchema: {
      type: 'object',
      properties: {
        task_id: { type: 'integer', description: 'Task ID' },
      },
      required: ['task_id'],
    },
  },

• src/tools/comments.ts:66-69 (registration)

  Registration of the 'comment_list' handler in the handlers mapping.

  export const handlers: Record<string, ToolHandler> = {
    comment_add: handleCommentAdd,
    comment_list: handleCommentList,
  };