Learning Hour MCP

Instructions

Implementation Reference

• src/index.ts:540-588 (handler)

  Main handler function for the 'get_miro_board' tool. Extracts boardId from input arguments, checks for Miro integration, calls MiroIntegration.getBoardInfo, and returns formatted text blocks with board details.

  private async getMiroBoard(args: any) {
    try {
      if (!this.miroIntegration) {
        throw new Error('Miro integration not initialized. Ensure MIRO_ACCESS_TOKEN is set in the environment.');
      }
  
      const boardId = args.boardId;
      if (!boardId) {
        throw new Error('Board ID is required');
      }
  
      const board = await this.miroIntegration.getBoardInfo(boardId);
  
      return {
        content: [
          {
            type: "text",
            text: `Board Details:`,
          },
          {
            type: "text",
            text: `Name: ${board.name}`,
          },
          {
            type: "text",
            text: `ID: ${board.id}`,
          },
          {
            type: "text",
            text: `Description: ${board.description || 'No description'}`,
          },
          {
            type: "text",
            text: `View Link: ${board.viewLink}`,
          },
          {
            type: "text",
            text: `Created: ${board.createdAt}`,
          },
          {
            type: "text",
            text: `Modified: ${board.modifiedAt}`,
          },
        ],
      };
    } catch (error) {
      throw new Error(`Failed to get Miro board: ${error instanceof Error ? error.message : String(error)}`);
    }
  }

• src/MiroIntegration.ts:121-133 (helper)

  Core helper method in MiroIntegration class that performs the actual API call to Miro's /boards/{boardId} endpoint to fetch board information.

  async getBoardInfo(boardId: string): Promise<MiroBoard> {
    try {
      const response = await axios.get(`${this.miroApiUrl}/boards/${boardId}`, {
        headers: {
          'authorization': `Bearer ${this.accessToken}`,
        }
      });
  
      return response.data;
    } catch (error) {
      throw new Error(`Failed to get board info: ${error instanceof Error ? error.message : String(error)}`);
    }
  }

• src/index.ts:202-215 (registration)

  Tool registration entry in the ListTools response, defining the tool name, description, and input schema requiring a 'boardId' string.

  {
    name: "get_miro_board",
    description: "Get details about a specific Miro board",
    inputSchema: {
      type: "object",
      properties: {
        boardId: {
          type: "string",
          description: "ID of the Miro board to get details for",
        },
      },
      required: ["boardId"],
    },
  },

• src/MiroIntegration.ts:8-15 (schema)

  TypeScript interface defining the structure of a MiroBoard object returned by the getBoardInfo method.

  interface MiroBoard {
    id: string;
    name: string;
    description?: string;
    createdAt: string;
    modifiedAt: string;
    viewLink: string;
  }