Connectry Architect Cert

Instructions

Implementation Reference

• src/tools/dashboard.ts:8-33 (handler)

  The implementation of the get_dashboard MCP tool handler within the registerDashboard function.

  export function registerDashboard(server: McpServer, db: Database.Database, userConfig: UserConfig): void {
    server.tool(
      'get_dashboard',
      'Open the study progress dashboard in Claude Preview. Shows mastery levels, exam history, activity timeline, and capstone progress.\n\nIMPORTANT: After getting the URL, use the preview_start tool to open it in Claude Preview. If the user says "show dashboard" or "open dashboard", call this tool.',
      {},
      async () => {
        if (!cachedServer) {
          cachedServer = await startDashboardServer(db, userConfig);
        }
  
        const url = `http://127.0.0.1:${cachedServer.port}/dashboard`;
  
        // Also build a text summary for non-Preview clients
        const summary = buildTextSummary(db, userConfig.userId);
  
        return {
          content: [
            {
              type: 'text' as const,
              text: `Dashboard ready at: ${url}\n\nUse preview_start to open this URL in Claude Preview.\n\n${summary}`,
            },
          ],
        };
      }
    );
  }