archive-all-cards-in-list
Archive all cards in a specified Trello list to clean up completed tasks or remove outdated items. Provide the list ID to execute this bulk archiving action.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| listId | Yes | ID of the list to archive all cards in |
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);