archive-all-cards-in-list

Implementation Reference

• src/tools/lists.ts:436-479 (handler)

  The handler function that implements the core logic of the tool by sending a POST request to the Trello API to archive all cards in the given list ID. Includes credential validation, API call, response handling, and error management.

  async ({ listId }) => {
  	try {
  		if (!credentials.apiKey || !credentials.apiToken) {
  			return {
  				content: [
  					{
  						type: 'text',
  						text: 'Trello API credentials are not configured',
  					},
  				],
  				isError: true,
  			};
  		}
  
  		const response = await fetch(
  			`https://api.trello.com/1/lists/${listId}/archiveAllCards?key=${credentials.apiKey}&token=${credentials.apiToken}`,
  			{
  				method: 'POST',
  				headers: {
  					'Content-Type': 'application/json',
  				},
  			}
  		);
  		const data = await response.json();
  		return {
  			content: [
  				{
  					type: 'text',
  					text: JSON.stringify(data),
  				},
  			],
  		};
  	} catch (error) {
  		return {
  			content: [
  				{
  					type: 'text',
  					text: `Error archiving all cards in list: ${error}`,
  				},
  			],
  			isError: true,
  		};
  	}
  }

• src/tools/lists.ts:433-435 (schema)

  Zod input schema defining the required 'listId' parameter as a string with description.

  {
  	listId: z.string().describe('ID of the list to archive all cards in'),
  },

• src/tools/lists.ts:431-480 (registration)

  Registration of the 'archive-all-cards-in-list' tool on the MCP server using server.tool(), including schema and handler.

  server.tool(
  	'archive-all-cards-in-list',
  	{
  		listId: z.string().describe('ID of the list to archive all cards in'),
  	},
  	async ({ listId }) => {
  		try {
  			if (!credentials.apiKey || !credentials.apiToken) {
  				return {
  					content: [
  						{
  							type: 'text',
  							text: 'Trello API credentials are not configured',
  						},
  					],
  					isError: true,
  				};
  			}
  
  			const response = await fetch(
  				`https://api.trello.com/1/lists/${listId}/archiveAllCards?key=${credentials.apiKey}&token=${credentials.apiToken}`,
  				{
  					method: 'POST',
  					headers: {
  						'Content-Type': 'application/json',
  					},
  				}
  			);
  			const data = await response.json();
  			return {
  				content: [
  					{
  						type: 'text',
  						text: JSON.stringify(data),
  					},
  				],
  			};
  		} catch (error) {
  			return {
  				content: [
  					{
  						type: 'text',
  						text: `Error archiving all cards in list: ${error}`,
  					},
  				],
  				isError: true,
  			};
  		}
  	}
  );

• src/index.ts:89-89 (registration)

  Invocation of registerListsTools which includes the registration of the archive-all-cards-in-list tool among other list tools.

  registerListsTools(server, credentials);