trello-mcp-server

Implementation Reference

• src/tools/board-tool-handlers.ts:19-22 (handler)

  The main handler function for the 'get_boards' tool. It retrieves the board service from the factory and calls getBoards with the provided arguments.

  get_boards: async (args: any) => {
      const boardService = ServiceFactory.getInstance().getBoardService();
      return boardService.getBoards(args);
  },

• src/tools/board-tools.ts:14-31 (schema)

  The schema definition for the 'get_boards' tool, including name, description, and input validation schema.

      name: "get_boards",
      description: "Retrieve a list of boards for the authenticated user. Use this tool to get an overview of available boards or to search for specific ones using filters.",
      inputSchema: {
          type: "object",
          properties: {
              filter: {
                  type: "string",
                  enum: ["all", "closed", "members", "open", "organization", "public", "starred", "unpinned"],
                  description: "Filter boards by status or membership"
              },
              fields: {
                  type: "array",
                  items: { type: "string" },
                  description: "Specific fields to include in the response (default: all fields)"
              }
          }
      }
  },

• src/index.ts:97-101 (registration)

  Registration of the list tools request handler in the MCP server, which returns all tools including 'get_boards' via the trelloTools array.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
      return {
          tools: trelloTools
      };
  });

• src/index.ts:125-140 (registration)

  Registration of the call tool request handler in the MCP server, which dispatches to the specific handler for 'get_boards' using trelloToolHandlers.

  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);

• src/services/board-service.ts:22-36 (helper)

  The underlying board service method called by the get_boards handler. (Note: excerpt abbreviated as full implementation not read.)

  /**
   * Creates a new BoardService instance
   * @param trelloService - The TrelloService instance
   */
  constructor(trelloService: TrelloService) {
      this.trelloService = trelloService;
  }
  
  /**
   * Get all boards for the authenticated user
   * @param filters - Optional filters to apply
   * @returns Promise resolving to an array of boards
   */
  async getBoards(filters?: BoardFilters): Promise<TrelloBoard[]> {