trello-mcp-server

Implementation Reference

• src/tools/card-tool-handlers.ts:24-32 (handler)

  The async handler function implementing the 'create_card' MCP tool. It retrieves the CardService from ServiceFactory and calls createCard with the tool arguments.
  /** * Create a new card * @param args - Tool arguments * @returns Promise resolving to the created card */ create_card: async (args: any) => { const cardService = ServiceFactory.getInstance().getCardService(); return cardService.createCard(args); },
• src/tools/card-tools.ts:33-102 (schema)

  The JSON schema definition and metadata for the 'create_card' tool, including input parameters and requirements.
  name: "create_card", description: "Create a new card on a list. Use this tool when you need to add a new card to a list.", inputSchema: { type: "object", properties: { name: { type: "string", description: "Name of the card" }, idList: { type: "string", description: "ID of the list the card should belong to" }, desc: { type: "string", description: "Description of the card" }, pos: { type: ["string", "number"], description: "Position of the card (top, bottom, or a positive number)" }, due: { type: ["string", "null"], description: "Due date for the card (ISO-8601 format, e.g., 2023-12-31T12:00:00Z)" }, start: { type: ["string", "null"], description: "Start date for the card (ISO-8601 format, e.g., 2023-12-31T12:00:00Z)" }, dueComplete: { type: "boolean", description: "Whether the due date is complete" }, idMembers: { type: "array", items: { type: "string" }, description: "IDs of members to assign to the card" }, idLabels: { type: "array", items: { type: "string" }, description: "IDs of labels to add to the card" }, urlSource: { type: "string", description: "URL to attach to the card" }, idCardSource: { type: "string", description: "ID of a card to copy from" }, keepFromSource: { type: "string", description: "What to copy from the source card (all or a comma-separated list of: attachments, checklists, comments, due, labels, members, stickers)" }, address: { type: "string", description: "Address for the card" }, locationName: { type: "string", description: "Location name for the card" }, coordinates: { type: "string", description: "Coordinates for the card (latitude,longitude)" } }, required: ["name", "idList"] }
• src/index.ts:97-101 (registration)

  MCP server registration for the ListToolsRequestSchema, which exposes the 'create_card' tool schema as part of trelloTools.
  server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: trelloTools }; });
• src/index.ts:125-142 (registration)

  MCP server registration for CallToolRequestSchema, which dispatches to the 'create_card' handler from trelloToolHandlers based on tool name.
  server.setRequestHandler(CallToolRequestSchema, async (request) => { try { 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]; if (!handler) { throw new McpError( ErrorCode.MethodNotFound, `Unknown tool: ${toolName}` ); } // Execute the tool handler with the provided arguments const result = await handler(request.params.arguments); // Return the result return {
• src/tools/trello-tools.ts:18-24 (registration)

  Aggregation of all tool schemas into trelloTools array, spreading cardTools which includes 'create_card'.
  export const trelloTools = [ ...boardTools, ...listTools, ...cardTools, ...memberTools, ...labelTools, ...checklistTools