Advanced Trello MCP Server

Implementation Reference

• src/tools/cards.ts:305-355 (handler)

  Handler function that processes an array of comments, checks credentials, makes parallel POST requests to Trello API to add comments to specified cards, and returns results or error.

  async ({ comments }) => {
  	try {
  		if (!credentials.apiKey || !credentials.apiToken) {
  			return {
  				content: [
  					{
  						type: 'text',
  						text: 'Trello API credentials are not configured',
  					},
  				],
  				isError: true,
  			};
  		}
  
  		const results = await Promise.all(
  			comments.map(async (comment) => {
  				const response = await fetch(
  					`https://api.trello.com/1/cards/${comment.cardId}/actions/comments?key=${credentials.apiKey}&token=${credentials.apiToken}`,
  					{
  						method: 'POST',
  						headers: {
  							'Content-Type': 'application/json',
  						},
  						body: JSON.stringify({
  							text: comment.text,
  						}),
  					}
  				);
  				return await response.json();
  			})
  		);
  		return {
  			content: [
  				{
  					type: 'text',
  					text: JSON.stringify(results),
  				},
  			],
  		};
  	} catch (error) {
  		return {
  			content: [
  				{
  					type: 'text',
  					text: `Error adding comments: ${error}`,
  				},
  			],
  			isError: true,
  		};
  	}
  }

• src/tools/cards.ts:297-304 (schema)

  Zod schema defining the input as an array of objects, each with cardId (string) and text (string).

  {
  	comments: z.array(
  		z.object({
  			cardId: z.string().describe('ID of the card to comment on'),
  			text: z.string().describe('Comment text'),
  		})
  	),
  },

• src/tools/cards.ts:295-356 (registration)

  Registration of the 'add-comments' tool within the registerCardsTools function using server.tool(name, schema, handler).

  server.tool(
  	'add-comments',
  	{
  		comments: z.array(
  			z.object({
  				cardId: z.string().describe('ID of the card to comment on'),
  				text: z.string().describe('Comment text'),
  			})
  		),
  	},
  	async ({ comments }) => {
  		try {
  			if (!credentials.apiKey || !credentials.apiToken) {
  				return {
  					content: [
  						{
  							type: 'text',
  							text: 'Trello API credentials are not configured',
  						},
  					],
  					isError: true,
  				};
  			}
  
  			const results = await Promise.all(
  				comments.map(async (comment) => {
  					const response = await fetch(
  						`https://api.trello.com/1/cards/${comment.cardId}/actions/comments?key=${credentials.apiKey}&token=${credentials.apiToken}`,
  						{
  							method: 'POST',
  							headers: {
  								'Content-Type': 'application/json',
  							},
  							body: JSON.stringify({
  								text: comment.text,
  							}),
  						}
  					);
  					return await response.json();
  				})
  			);
  			return {
  				content: [
  					{
  						type: 'text',
  						text: JSON.stringify(results),
  					},
  				],
  			};
  		} catch (error) {
  			return {
  				content: [
  					{
  						type: 'text',
  						text: `Error adding comments: ${error}`,
  					},
  				],
  				isError: true,
  			};
  		}
  	}
  );