list_miro_boards
Retrieve accessible Miro boards for Learning Hour content creation, enabling Technical Coaches to organize deliberate practice sessions with structured visual collaboration tools.
Instructions
List all Miro boards accessible with the current token
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of boards to return (default: 50, max: 50) | |
| cursor | No | Cursor for pagination |
Implementation Reference
- src/MiroIntegration.ts:98-119 (handler)Core implementation of listing Miro boards. Makes authenticated GET request to Miro API /boards endpoint with optional pagination parameters (limit, cursor), processes response, and handles errors.
async listBoards(limit: number = 50, cursor?: string): Promise<{ data: MiroBoard[], cursor?: string }> { try { const params: any = { limit }; if (cursor) { params.cursor = cursor; } const response = await axios.get(`${this.miroApiUrl}/boards`, { headers: { 'authorization': `Bearer ${this.accessToken}`, }, params }); return { data: response.data.data || [], cursor: response.data.cursor }; } catch (error: any) { throw new Error(`Failed to list boards: ${error.response?.data?.message || error.message}`); } } - src/index.ts:499-538 (handler)MCP tool handler for 'list_miro_boards'. Validates Miro integration, extracts parameters from args, delegates to MiroIntegration.listBoards, formats boards list into MCP content response with pagination info.
private async listMiroBoards(args: any) { try { if (!this.miroIntegration) { throw new Error('Miro integration not initialized. Ensure MIRO_ACCESS_TOKEN is set in the environment.'); } const limit = args.limit || 50; const cursor = args.cursor; const result = await this.miroIntegration.listBoards(limit, cursor); const boards = result.data.map((board: any) => ({ id: board.id, name: board.name, description: board.description || '', viewLink: board.viewLink, createdAt: board.createdAt, modifiedAt: board.modifiedAt })); return { content: [ { type: "text", text: `Found ${boards.length} Miro boards:`, }, { type: "text", text: boards.map((b: any) => `- ${b.name} (ID: ${b.id})`).join('\n'), }, ...(result.cursor ? [{ type: "text", text: `\nMore boards available. Use cursor: ${result.cursor}`, }] : []), ], }; } catch (error) { throw new Error(`Failed to list Miro boards: ${error instanceof Error ? error.message : String(error)}`); } } - src/index.ts:186-201 (registration)Tool registration in ListToolsRequestSchema handler, including name, description, and input schema definition.
name: "list_miro_boards", description: "List all Miro boards accessible with the current token", inputSchema: { type: "object", properties: { limit: { type: "number", description: "Maximum number of boards to return (default: 50, max: 50)", }, cursor: { type: "string", description: "Cursor for pagination", }, }, }, }, - src/index.ts:250-251 (handler)Dispatch case in central CallToolRequestSchema handler that routes 'list_miro_boards' calls to the listMiroBoards method.
case "list_miro_boards": return await this.listMiroBoards(request.params.arguments);