create-list

Implementation Reference

• src/tools/lists.ts:52-101 (handler)

  Handler function that creates a new Trello list using POST /lists endpoint with provided boardId, name, and optional position.

  	async ({ boardId, name, position = 'bottom' }) => {
  		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?key=${credentials.apiKey}&token=${credentials.apiToken}`,
  				{
  					method: 'POST',
  					headers: {
  						'Content-Type': 'application/json',
  					},
  					body: JSON.stringify({
  						name,
  						idBoard: boardId,
  						pos: position,
  					}),
  				}
  			);
  			const data = await response.json();
  			return {
  				content: [
  					{
  						type: 'text',
  						text: JSON.stringify(data),
  					},
  				],
  			};
  		} catch (error) {
  			return {
  				content: [
  					{
  						type: 'text',
  						text: `Error creating list: ${error}`,
  					},
  				],
  				isError: true,
  			};
  		}
  	}
  );

• src/tools/lists.ts:47-51 (schema)

  Input schema using Zod for validating parameters: boardId, name, and optional position.

  {
  	boardId: z.string().describe('ID of the board to create the list in'),
  	name: z.string().describe('Name of the list'),
  	position: z.string().optional().describe('Position of the list (e.g. "top", "bottom", or a number)'),
  },

• src/tools/lists.ts:46-101 (registration)

  The server.tool() call within registerListsTools that registers the 'create-list' tool, including schema and handler.

  	'create-list',
  	{
  		boardId: z.string().describe('ID of the board to create the list in'),
  		name: z.string().describe('Name of the list'),
  		position: z.string().optional().describe('Position of the list (e.g. "top", "bottom", or a number)'),
  	},
  	async ({ boardId, name, position = 'bottom' }) => {
  		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?key=${credentials.apiKey}&token=${credentials.apiToken}`,
  				{
  					method: 'POST',
  					headers: {
  						'Content-Type': 'application/json',
  					},
  					body: JSON.stringify({
  						name,
  						idBoard: boardId,
  						pos: position,
  					}),
  				}
  			);
  			const data = await response.json();
  			return {
  				content: [
  					{
  						type: 'text',
  						text: JSON.stringify(data),
  					},
  				],
  			};
  		} catch (error) {
  			return {
  				content: [
  					{
  						type: 'text',
  						text: `Error creating list: ${error}`,
  					},
  				],
  				isError: true,
  			};
  		}
  	}
  );

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

  Invocation of registerListsTools in the main server setup, which registers all list tools including 'create-list'.

  registerListsTools(server, credentials);