Dart MCP Server

Instructions

Implementation Reference

• index.ts:474-484 (handler)

  The switch case in the CallToolRequestSchema handler that implements the logic for the 'add_task_comment' tool: validates taskId, constructs comment data, calls CommentService.addTaskComment, and returns the JSON stringified result.

  case ADD_TASK_COMMENT_TOOL.name: {
    const taskId = getIdValidated(args.taskId);
    const text = args.text;
    const commentData = { taskId, text } as CommentCreate;
    const comment = await CommentService.addTaskComment({
      item: commentData,
    });
    return {
      content: [{ type: "text", text: JSON.stringify(comment, null, 2) }],
    };
  }

• tools.ts:369-389 (schema)

  The Tool object definition for 'add_task_comment', specifying the name, description, and inputSchema with required taskId and text parameters.

  export const ADD_TASK_COMMENT_TOOL: Tool = {
    name: "add_task_comment",
    description:
      "Add a comment to an existing task without modifying the task description. Comments support markdown formatting.",
    inputSchema: {
      type: "object",
      properties: {
        taskId: {
          type: "string",
          description: "The 12-character alphanumeric ID of the task",
          pattern: "^[a-zA-Z0-9]{12}$",
        },
        text: {
          type: "string",
          description:
            "The full content of the comment, which can include markdown formatting.",
        },
      },
      required: ["taskId", "text"],
    },
  };

• index.ts:192-214 (registration)

  The TOOLS array registers ADD_TASK_COMMENT_TOOL among other tools, which is provided in response to ListToolsRequestSchema.

  const TOOLS = [
    // Config
    GET_CONFIG_TOOL,
    // Tasks
    CREATE_TASK_TOOL,
    LIST_TASKS_TOOL,
    GET_TASK_TOOL,
    UPDATE_TASK_TOOL,
    DELETE_TASK_TOOL,
    // Docs
    CREATE_DOC_TOOL,
    LIST_DOCS_TOOL,
    GET_DOC_TOOL,
    UPDATE_DOC_TOOL,
    DELETE_DOC_TOOL,
    // Comments
    ADD_TASK_COMMENT_TOOL,
    LIST_TASK_COMMENTS_TOOL,
    // Other
    GET_DARTBOARD_TOOL,
    GET_FOLDER_TOOL,
    GET_VIEW_TOOL,
  ];

• index.ts:35-52 (registration)

  Import statement that brings ADD_TASK_COMMENT_TOOL into index.ts for use in handlers and registration.

  import {
    ADD_TASK_COMMENT_TOOL,
    CREATE_DOC_TOOL,
    CREATE_TASK_TOOL,
    DELETE_DOC_TOOL,
    DELETE_TASK_TOOL,
    GET_CONFIG_TOOL,
    GET_DARTBOARD_TOOL,
    GET_DOC_TOOL,
    GET_FOLDER_TOOL,
    GET_TASK_TOOL,
    GET_VIEW_TOOL,
    LIST_DOCS_TOOL,
    LIST_TASK_COMMENTS_TOOL,
    LIST_TASKS_TOOL,
    UPDATE_DOC_TOOL,
    UPDATE_TASK_TOOL,
  } from "./tools.js";