Trello MCP Server

Instructions

Implementation Reference

• src/index.ts:178-184 (handler)

  Handler for the 'get_cards' tool. Extracts board_id and optional list_id from arguments, calls TrelloClient.getCards, and returns JSON stringified cards.

  case 'get_cards': {
    const { board_id, list_id } = (request.params.arguments as { request: GetCardsRequest }).request;
    const cards = await this.trelloClient.getCards(board_id, list_id);
    return {
      content: [{ type: 'text', text: JSON.stringify(cards, null, 2) }],
    };
  }

• src/index.ts:86-110 (registration)

  Registration of the 'get_cards' tool in the ListToolsRequestHandler, including name, description, and inputSchema.

  {
    name: 'get_cards',
    description: 'Get cards from a board or specific list',
    inputSchema: {
      type: 'object',
      properties: {
        request: {
          type: 'object',
          properties: {
            board_id: {
              type: 'string',
              description: 'ID of the board',
            },
            list_id: {
              type: 'string',
              description: 'Optional ID of a specific list',
            },
          },
          required: ['board_id'],
        },
      },
      required: ['request'],
      title: 'get_cardsArguments',
    },
  },

• src/types.ts:49-52 (schema)

  TypeScript interface definition for GetCardsRequest, used for type-checking the tool arguments in the handler.

  export interface GetCardsRequest {
    board_id: string;
    list_id?: string;
  }

• src/trello-client.ts:30-36 (helper)

  Core implementation of fetching cards from Trello API, either from a specific list or all board cards, called by the tool handler.

  async getCards(boardId: string, listId?: string): Promise<Card[]> {
    const endpoint = listId
      ? `${this.baseUrl}/lists/${listId}/cards`
      : `${this.baseUrl}/boards/${boardId}/cards`;
    const response = await axios.get(`${endpoint}?${this.getAuthParams()}`);
    return response.data;
  }