add-comments

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "comments": "<comments>"
    },
    "name": "add-comments"
  }
}

Implementation Reference

• src/tools/card-tool-handlers.ts:90-98 (handler)

  The handler function that executes the logic for the "add_comment" MCP tool by invoking the CardService.addComment method.

  /**
   * Add a comment to a card
   * @param args - Tool arguments
   * @returns Promise resolving to the created comment
   */
  add_comment: async (args: any) => {
      const cardService = ServiceFactory.getInstance().getCardService();
      return cardService.addComment(args.cardId, args.text);
  },

• src/tools/card-tools.ts:277-294 (schema)

  The JSON schema definition and metadata for the "add_comment" tool, including input schema validation.

  {
      name: "add_comment",
      description: "Add a comment to a card. Use this tool to add notes or feedback to a card.",
      inputSchema: {
          type: "object",
          properties: {
              cardId: {
                  type: "string",
                  description: "ID of the card"
              },
              text: {
                  type: "string",
                  description: "Text of the comment"
              }
          },
          required: ["cardId", "text"]
      }
  },

• src/services/card-service.ts:140-147 (helper)

  The supporting service method in CardService that performs the actual API call to add a comment to a Trello card.

   * Add a comment to a card
   * @param cardId - ID of the card
   * @param text - Comment text
   * @returns Promise resolving to the created comment
   */
  async addComment(cardId: string, text: string): Promise<any> {
      return this.trelloService.post<any>(`/cards/${cardId}/actions/comments`, { text });
  }

• src/index.ts:97-101 (registration)

  Registration of the tool list handler in the MCP server, which exposes the "add_comment" tool schema as part of trelloTools.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
      return {
          tools: trelloTools
      };
  });

• src/index.ts:127-130 (registration)

  Dynamic handler resolution in the MCP tool call handler, which dispatches to the "add_comment" handler from trelloToolHandlers.

  const toolName = request.params.name;
  // Use type assertion to tell TypeScript that toolName is a valid key
  const handler = trelloToolHandlers[toolName as keyof typeof trelloToolHandlers];