@prodbeam/mcp 0.1.1 → 0.2.0

package/dist/index.js

@@ -1,24 +1,54 @@
 #!/usr/bin/env node
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { resolveGitHubCredentials, resolveJiraCredentials } from './config/credentials.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { readTeamConfig, writeTeamConfig, teamConfigExists, createDefaultConfig, } from './config/team-config.js';
 import { resolveConfigDir } from './config/paths.js';
 import { GitHubClient } from './clients/github-client.js';
 import { JiraClient } from './clients/jira-client.js';
+import { resolveGitHubAuth, resolveJiraAuth, getAuthStatuses, AuthExpiredError, } from './auth/auth-provider.js';
 import { discoverGitHubTeam } from './discovery/github-discovery.js';
 import { discoverJiraTeam } from './discovery/jira-discovery.js';
 import { fetchGitHubActivityForUser, fetchTeamGitHubActivity, fetchJiraActivityForUser, fetchTeamJiraActivity, fetchSprintJiraActivity, detectActiveSprint, } from './orchestrator/data-fetcher.js';
 import { dailyTimeRange, weeklyTimeRange, sprintTimeRange } from './orchestrator/time-range.js';
-import { generateDailyReport, generateTeamDailyReport, generateWeeklyReport, generateRetrospective, } from './generators/report-generator.js';
+import { generateDailyReport, generateTeamDailyReport, generateWeeklyReport, generateRetrospective, generateSprintReview, } from './generators/report-generator.js';
 import { HistoryStore } from './history/history-store.js';
 import { buildSnapshot } from './history/snapshot-builder.js';
 import { analyzeTrends } from './insights/trend-analyzer.js';
 import { detectAnomalies } from './insights/anomaly-detector.js';
 import { assessTeamHealth } from './insights/team-health.js';
 import { resolveThresholds } from './config/thresholds.js';
-const server = new Server({ name: 'prodbeam', version: '2.0.0' }, { capabilities: { tools: {} } });
+const SERVER_INSTRUCTIONS = `Prodbeam is an engineering intelligence server that generates reports from GitHub and Jira data.
+
+Use prodbeam tools when the user asks about:
+- Daily standups, what they or their team worked on, yesterday's activity → standup or team_standup
+- Weekly engineering summaries, metrics, productivity reports → weekly_summary
+- Sprint retrospectives, retros, sprint reviews, sprint health → sprint_retro or sprint_review
+- Team setup, adding/removing members, configuration → setup_team, add_member, remove_member
+- Refreshing repos/sprints, re-scanning → refresh_config
+- What tools are available, credential status → get_capabilities
+
+Common triggers: "standup", "what did I do", "weekly report", "sprint retro", "sprint review", "team activity", "engineering metrics"`;
+const server = new Server({ name: 'prodbeam', version: '2.0.0' }, {
+    capabilities: { tools: {}, prompts: {} },
+    instructions: SERVER_INSTRUCTIONS,
+});
+async function createGitHubClient() {
+    const auth = await resolveGitHubAuth();
+    if (!auth) {
+        throw new Error('GitHub credentials required. Set GITHUB_TOKEN or run "prodbeam auth login".');
+    }
+    return new GitHubClient(auth.token);
+}
+async function createJiraClient() {
+    const auth = await resolveJiraAuth();
+    if (!auth)
+        return null;
+    return new JiraClient({
+        getBaseUrl: () => auth.baseUrl,
+        getAuthHeader: () => Promise.resolve(auth.authHeader),
+    });
+}
 server.setRequestHandler(ListToolsRequestSchema, () => {
     return {
         tools: [
@@ -79,7 +109,7 @@ server.setRequestHandler(ListToolsRequestSchema, () => {
             },
             {
                 name: 'standup',
-                description: 'Generate a personal daily standup report. Fetches your GitHub commits, PRs, reviews, and Jira issues from the last 24 hours. Requires team setup.',
+                description: 'Generate a personal daily standup report. Fetches your GitHub commits, PRs, reviews, and Jira issues from the last 24 hours. Use when the user asks: "standup", "what did I work on", "my activity", "daily update". Requires team setup.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -92,7 +122,7 @@ server.setRequestHandler(ListToolsRequestSchema, () => {
             },
             {
                 name: 'team_standup',
-                description: 'Generate a full team standup report. Shows per-member activity from the last 24 hours with aggregate stats.',
+                description: 'Generate a full team standup report. Shows per-member activity from the last 24 hours with aggregate stats. Use when the user asks: "team standup", "what did the team do", "team activity", "everyone\'s update".',
                 inputSchema: {
                     type: 'object',
                     properties: {},
@@ -100,7 +130,7 @@ server.setRequestHandler(ListToolsRequestSchema, () => {
             },
             {
                 name: 'weekly_summary',
-                description: 'Generate a weekly engineering summary with metrics, repo breakdown, and Jira stats. Covers the last 7 days by default.',
+                description: 'Generate a weekly engineering summary with metrics, repo breakdown, and Jira stats. Covers the last 7 days by default. Use when the user asks: "weekly summary", "weekly report", "this week\'s metrics", "engineering summary", "productivity report".',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -113,7 +143,20 @@ server.setRequestHandler(ListToolsRequestSchema, () => {
             },
             {
                 name: 'sprint_retro',
-                description: 'Generate a sprint retrospective report with merge time analysis, completion rates, and Jira metrics. Auto-detects the active sprint from Jira.',
+                description: 'Generate a sprint retrospective report with merge time analysis, completion rates, and Jira metrics. Auto-detects the active sprint from Jira. Use when the user asks: "sprint retro", "retrospective", "sprint review meeting", "how did the sprint go".',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        sprintName: {
+                            type: 'string',
+                            description: 'Sprint name (optional — auto-detects active sprint if not provided)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'sprint_review',
+                description: 'Review current sprint progress with deliverables, risks, and developer status. Mid-sprint health check. Use when the user asks: "sprint review", "sprint status", "sprint health", "how is the sprint going", "sprint progress".',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -135,6 +178,98 @@ server.setRequestHandler(ListToolsRequestSchema, () => {
         ],
     };
 });
+const PROMPTS = [
+    {
+        name: 'standup',
+        description: 'Generate your personal daily standup report',
+        arguments: [
+            {
+                name: 'email',
+                description: 'Team member email (optional — defaults to first member)',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'team-standup',
+        description: "Generate the full team's daily standup report",
+    },
+    {
+        name: 'weekly-summary',
+        description: 'Generate a weekly engineering summary with metrics',
+        arguments: [
+            {
+                name: 'weeksAgo',
+                description: 'Offset in weeks (0 = current, 1 = last week)',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'sprint-retro',
+        description: 'Generate a sprint retrospective with what went well, improvements, and action items',
+        arguments: [
+            {
+                name: 'sprintName',
+                description: 'Sprint name (optional — auto-detects active sprint)',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'sprint-review',
+        description: 'Review current sprint progress, deliverables, and risks',
+        arguments: [
+            {
+                name: 'sprintName',
+                description: 'Sprint name (optional — auto-detects active sprint)',
+                required: false,
+            },
+        ],
+    },
+];
+server.setRequestHandler(ListPromptsRequestSchema, () => {
+    return { prompts: PROMPTS };
+});
+server.setRequestHandler(GetPromptRequestSchema, (request) => {
+    const { name, arguments: promptArgs } = request.params;
+    const prompt = PROMPTS.find((p) => p.name === name);
+    if (!prompt) {
+        throw new Error(`Unknown prompt: ${name}`);
+    }
+    const toolMap = {
+        standup: { tool: 'standup', argMap: { email: 'email' } },
+        'team-standup': { tool: 'team_standup', argMap: {} },
+        'weekly-summary': { tool: 'weekly_summary', argMap: { weeksAgo: 'weeksAgo' } },
+        'sprint-retro': { tool: 'sprint_retro', argMap: { sprintName: 'sprintName' } },
+        'sprint-review': { tool: 'sprint_review', argMap: { sprintName: 'sprintName' } },
+    };
+    const mapping = toolMap[name];
+    if (!mapping) {
+        throw new Error(`Unknown prompt: ${name}`);
+    }
+    const toolArgs = {};
+    if (promptArgs) {
+        for (const [promptKey, toolKey] of Object.entries(mapping.argMap)) {
+            if (promptArgs[promptKey]) {
+                toolArgs[toolKey] = promptArgs[promptKey];
+            }
+        }
+    }
+    const argsDescription = Object.keys(toolArgs).length > 0 ? ` with ${JSON.stringify(toolArgs)}` : '';
+    return {
+        description: prompt.description,
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Use the prodbeam ${mapping.tool} tool${argsDescription} to generate the report.`,
+                },
+            },
+        ],
+    };
+});
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     try {
@@ -155,6 +290,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return await handleWeeklySummary(args);
             case 'sprint_retro':
                 return await handleSprintRetro(args);
+            case 'sprint_review':
+                return await handleSprintReview(args);
             case 'get_capabilities':
                 return handleGetCapabilities();
             default:
@@ -162,6 +299,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
     }
     catch (error) {
+        if (error instanceof AuthExpiredError) {
+            return {
+                content: [{ type: 'text', text: `Authentication expired: ${error.message}` }],
+                isError: true,
+            };
+        }
         const errorMessage = error instanceof Error ? error.message : 'Unknown error';
         return {
             content: [{ type: 'text', text: `Error: ${errorMessage}` }],
@@ -189,11 +332,10 @@ async function handleSetupTeam(args) {
     parts.push(`**Team:** ${teamName}`);
     parts.push(`**Config directory:** ${resolveConfigDir()}`);
     parts.push('');
-    const ghCreds = resolveGitHubCredentials();
-    if (ghCreds) {
+    const ghClient = await createGitHubClient().catch(() => null);
+    if (ghClient) {
         parts.push('## GitHub Discovery');
         parts.push('');
-        const ghClient = new GitHubClient(ghCreds.token);
         const ghResult = await discoverGitHubTeam(ghClient, emailList);
         for (const member of ghResult.members) {
             const configMember = config.team.members.find((m) => m.email === member.email);
@@ -222,15 +364,15 @@ async function handleSetupTeam(args) {
     else {
         parts.push('## GitHub Discovery');
         parts.push('');
-        parts.push('⚠️ No GitHub credentials found. Set `GITHUB_TOKEN` env var or run setup again after configuring credentials.');
+        parts.push('⚠️ No GitHub credentials found. Set `GITHUB_TOKEN` env var or run `prodbeam auth login`.');
         parts.push('');
     }
-    const jiraCreds = resolveJiraCredentials();
-    if (jiraCreds) {
+    const setupJiraClient = await createJiraClient().catch(() => null);
+    const setupJiraAuth = setupJiraClient ? await resolveJiraAuth().catch(() => null) : null;
+    if (setupJiraClient) {
         parts.push('## Jira Discovery');
         parts.push('');
-        const jiraClient = new JiraClient(jiraCreds.host, jiraCreds.email, jiraCreds.apiToken);
-        const jiraResult = await discoverJiraTeam(jiraClient, emailList, jiraCreds.host);
+        const jiraResult = await discoverJiraTeam(setupJiraClient, emailList, setupJiraAuth?.baseUrl ?? '');
         config.jira.host = jiraResult.host;
         for (const member of jiraResult.members) {
             const configMember = config.team.members.find((m) => m.email === member.email);
@@ -263,7 +405,7 @@ async function handleSetupTeam(args) {
     else {
         parts.push('## Jira Discovery');
         parts.push('');
-        parts.push('⚠️ No Jira credentials found. Set `JIRA_HOST`, `JIRA_EMAIL`, and `JIRA_API_TOKEN` env vars or configure credentials.');
+        parts.push('⚠️ No Jira credentials found. Set Jira env vars or run `prodbeam auth login`.');
         parts.push('');
     }
     writeTeamConfig(config);
@@ -293,15 +435,14 @@ async function handleAddMember(args) {
     const parts = [];
     parts.push(`# Add Member: ${email}`);
     parts.push('');
-    const ghCreds = resolveGitHubCredentials();
-    if (ghCreds) {
-        const ghClient = new GitHubClient(ghCreds.token);
-        const username = await ghClient.searchUserByEmail(email);
+    const addGhClient = await createGitHubClient().catch(() => null);
+    if (addGhClient) {
+        const username = await addGhClient.searchUserByEmail(email);
         if (username) {
             newMember.github = username;
             newMember.name = username;
             parts.push(`GitHub: @${username}`);
-            const repos = await ghClient.getRecentRepos(username).catch(() => []);
+            const repos = await addGhClient.getRecentRepos(username).catch(() => []);
             const newRepos = repos.filter((r) => !config.github.repos.includes(r));
             if (newRepos.length > 0) {
                 config.github.repos.push(...newRepos);
@@ -312,10 +453,9 @@ async function handleAddMember(args) {
             parts.push(`GitHub: not found for ${email}`);
         }
     }
-    const jiraCreds = resolveJiraCredentials();
-    if (jiraCreds) {
-        const jiraClient = new JiraClient(jiraCreds.host, jiraCreds.email, jiraCreds.apiToken);
-        const user = await jiraClient.searchUserByEmail(email);
+    const addJiraClient = await createJiraClient().catch(() => null);
+    if (addJiraClient) {
+        const user = await addJiraClient.searchUserByEmail(email);
         if (user) {
             newMember.jiraAccountId = user.accountId;
             if (!newMember.name) {
@@ -371,10 +511,9 @@ async function handleRefreshConfig() {
     parts.push('# Config Refresh');
     parts.push('');
     const emails = config.team.members.map((m) => m.email);
-    const ghCreds = resolveGitHubCredentials();
-    if (ghCreds) {
-        const ghClient = new GitHubClient(ghCreds.token);
-        const ghResult = await discoverGitHubTeam(ghClient, emails);
+    const refreshGhClient = await createGitHubClient().catch(() => null);
+    if (refreshGhClient) {
+        const ghResult = await discoverGitHubTeam(refreshGhClient, emails);
         for (const member of ghResult.members) {
             const configMember = config.team.members.find((m) => m.email === member.email);
             if (configMember && member.username) {
@@ -394,10 +533,10 @@ async function handleRefreshConfig() {
             config.github.org = ghResult.orgs[0];
         }
     }
-    const jiraCreds = resolveJiraCredentials();
-    if (jiraCreds) {
-        const jiraClient = new JiraClient(jiraCreds.host, jiraCreds.email, jiraCreds.apiToken);
-        const jiraResult = await discoverJiraTeam(jiraClient, emails, jiraCreds.host);
+    const refreshJiraClient = await createJiraClient().catch(() => null);
+    const refreshJiraAuth = refreshJiraClient ? await resolveJiraAuth().catch(() => null) : null;
+    if (refreshJiraClient) {
+        const jiraResult = await discoverJiraTeam(refreshJiraClient, emails, refreshJiraAuth?.baseUrl ?? '');
         for (const member of jiraResult.members) {
             const configMember = config.team.members.find((m) => m.email === member.email);
             if (configMember && member.accountId) {
@@ -429,43 +568,31 @@ async function handleStandup(args) {
         throw new Error(`No GitHub username for ${member.email}. Run refresh_config to re-discover.`);
     }
     const timeRange = dailyTimeRange();
-    const ghCreds = resolveGitHubCredentials();
-    if (!ghCreds) {
-        throw new Error('GitHub credentials required. Set GITHUB_TOKEN env var.');
-    }
-    const ghClient = new GitHubClient(ghCreds.token);
-    const github = await fetchGitHubActivityForUser(ghClient, member.github, config.github.repos, timeRange);
+    const standupGhClient = await createGitHubClient();
+    const github = await fetchGitHubActivityForUser(standupGhClient, member.github, config.github.repos, timeRange);
     let jira;
-    const jiraCreds = resolveJiraCredentials();
-    if (jiraCreds && member.jiraAccountId) {
-        const jiraClient = new JiraClient(jiraCreds.host, jiraCreds.email, jiraCreds.apiToken);
-        jira = await fetchJiraActivityForUser(jiraClient, member.jiraAccountId, config.jira.projects, timeRange);
+    const standupJiraClient = await createJiraClient().catch(() => null);
+    if (standupJiraClient && member.jiraAccountId) {
+        jira = await fetchJiraActivityForUser(standupJiraClient, member.jiraAccountId, config.jira.projects, timeRange);
     }
     const report = generateDailyReport({ github, jira });
     return { content: [{ type: 'text', text: report }] };
 }
 async function handleTeamStandup() {
     const config = requireTeamConfig();
-    const ghCreds = resolveGitHubCredentials();
-    if (!ghCreds) {
-        throw new Error('GitHub credentials required. Set GITHUB_TOKEN env var.');
-    }
     const timeRange = dailyTimeRange();
-    const ghClient = new GitHubClient(ghCreds.token);
-    const jiraCreds = resolveJiraCredentials();
-    const jiraClient = jiraCreds
-        ? new JiraClient(jiraCreds.host, jiraCreds.email, jiraCreds.apiToken)
-        : null;
+    const teamGhClient = await createGitHubClient();
+    const teamJiraClient = await createJiraClient().catch(() => null);
     const membersWithGH = config.team.members.filter((m) => m.github);
     const usernames = membersWithGH.map((m) => m.github);
-    const ghActivities = await fetchTeamGitHubActivity(ghClient, usernames, config.github.repos, timeRange);
+    const ghActivities = await fetchTeamGitHubActivity(teamGhClient, usernames, config.github.repos, timeRange);
     const memberActivities = [];
     for (let i = 0; i < membersWithGH.length; i++) {
         const member = membersWithGH[i];
         const github = ghActivities[i];
         let jira;
-        if (jiraClient && member.jiraAccountId) {
-            jira = await fetchJiraActivityForUser(jiraClient, member.jiraAccountId, config.jira.projects, timeRange);
+        if (teamJiraClient && member.jiraAccountId) {
+            jira = await fetchJiraActivityForUser(teamJiraClient, member.jiraAccountId, config.jira.projects, timeRange);
         }
         memberActivities.push({ github, jira });
     }
@@ -474,22 +601,17 @@ async function handleTeamStandup() {
 }
 async function handleWeeklySummary(args) {
     const config = requireTeamConfig();
-    const ghCreds = resolveGitHubCredentials();
-    if (!ghCreds) {
-        throw new Error('GitHub credentials required. Set GITHUB_TOKEN env var.');
-    }
     const weeksAgo = typeof args?.['weeksAgo'] === 'number' ? args['weeksAgo'] : 0;
     const timeRange = weeklyTimeRange(weeksAgo);
-    const ghClient = new GitHubClient(ghCreds.token);
+    const weeklyGhClient = await createGitHubClient();
     const membersWithGH = config.team.members.filter((m) => m.github);
     const usernames = membersWithGH.map((m) => m.github);
-    const perMember = await fetchTeamGitHubActivity(ghClient, usernames, config.github.repos, timeRange);
+    const perMember = await fetchTeamGitHubActivity(weeklyGhClient, usernames, config.github.repos, timeRange);
     const github = mergeGitHubActivities(perMember, config.team.name, timeRange);
     let jira;
-    const jiraCreds = resolveJiraCredentials();
-    if (jiraCreds) {
-        const jiraClient = new JiraClient(jiraCreds.host, jiraCreds.email, jiraCreds.apiToken);
-        jira = await fetchTeamJiraActivity(jiraClient, config.jira.projects, timeRange);
+    const weeklyJiraClient = await createJiraClient().catch(() => null);
+    if (weeklyJiraClient) {
+        jira = await fetchTeamJiraActivity(weeklyJiraClient, config.jira.projects, timeRange);
     }
     const snapshot = buildSnapshot({
         teamName: config.team.name,
@@ -524,23 +646,21 @@ async function handleWeeklySummary(args) {
     }
     catch {
     }
-    const report = generateWeeklyReport({ github, jira }, extras);
+    const report = generateWeeklyReport({ github, jira, perMember }, extras);
     return { content: [{ type: 'text', text: report }] };
 }
 async function handleSprintRetro(args) {
     const config = requireTeamConfig();
-    const ghCreds = resolveGitHubCredentials();
-    const jiraCreds = resolveJiraCredentials();
-    if (!ghCreds) {
-        throw new Error('GitHub credentials required. Set GITHUB_TOKEN env var.');
-    }
+    const retroGhClient = await createGitHubClient();
+    const retroJiraClient = await createJiraClient().catch(() => null);
     let sprintName = typeof args?.['sprintName'] === 'string' ? args['sprintName'] : undefined;
     let timeRange;
-    if (!sprintName && jiraCreds) {
-        const jiraClient = new JiraClient(jiraCreds.host, jiraCreds.email, jiraCreds.apiToken);
-        const activeSprint = await detectActiveSprint(jiraClient, config.jira.projects);
+    let sprintGoal;
+    if (!sprintName && retroJiraClient) {
+        const activeSprint = await detectActiveSprint(retroJiraClient, config.jira.projects);
         if (activeSprint) {
             sprintName = activeSprint.name;
+            sprintGoal = activeSprint.goal;
             timeRange = sprintTimeRange(activeSprint.startDate, activeSprint.endDate);
         }
     }
@@ -552,15 +672,13 @@ async function handleSprintRetro(args) {
         const from = new Date(new Date(timeRange.to).getTime() - 14 * 24 * 60 * 60 * 1000);
         timeRange = { from: from.toISOString(), to: timeRange.to };
     }
-    const ghClient = new GitHubClient(ghCreds.token);
-    const membersWithGH = config.team.members.filter((m) => m.github);
-    const usernames = membersWithGH.map((m) => m.github);
-    const perMember = await fetchTeamGitHubActivity(ghClient, usernames, config.github.repos, timeRange);
+    const retroMembersWithGH = config.team.members.filter((m) => m.github);
+    const retroUsernames = retroMembersWithGH.map((m) => m.github);
+    const perMember = await fetchTeamGitHubActivity(retroGhClient, retroUsernames, config.github.repos, timeRange);
     const github = mergeGitHubActivities(perMember, config.team.name, timeRange);
     let jira;
-    if (jiraCreds) {
-        const jiraClient = new JiraClient(jiraCreds.host, jiraCreds.email, jiraCreds.apiToken);
-        jira = await fetchSprintJiraActivity(jiraClient, sprintName, timeRange);
+    if (retroJiraClient) {
+        jira = await fetchSprintJiraActivity(retroJiraClient, sprintName, timeRange);
     }
     const dateRange = {
         from: timeRange.from.split('T')[0],
@@ -600,7 +718,69 @@ async function handleSprintRetro(args) {
     }
     catch {
     }
-    const report = generateRetrospective({ github, jira, sprintName, dateRange }, extras);
+    const report = generateRetrospective({ github, jira, sprintName, dateRange, sprintGoal, perMember }, extras);
+    return { content: [{ type: 'text', text: report }] };
+}
+async function handleSprintReview(args) {
+    const config = requireTeamConfig();
+    const reviewGhClient = await createGitHubClient();
+    const reviewJiraClient = await createJiraClient().catch(() => null);
+    let sprintName = typeof args?.['sprintName'] === 'string' ? args['sprintName'] : undefined;
+    let timeRange;
+    let sprintGoal;
+    let sprintStartDate;
+    let sprintEndDate;
+    if (!sprintName && reviewJiraClient) {
+        const activeSprint = await detectActiveSprint(reviewJiraClient, config.jira.projects);
+        if (activeSprint) {
+            sprintName = activeSprint.name;
+            sprintGoal = activeSprint.goal;
+            sprintStartDate = activeSprint.startDate;
+            sprintEndDate = activeSprint.endDate;
+            timeRange = sprintTimeRange(activeSprint.startDate, activeSprint.endDate);
+        }
+    }
+    if (!sprintName) {
+        throw new Error('No active sprint detected. Provide a sprintName parameter or ensure Jira credentials are configured.');
+    }
+    if (!timeRange) {
+        timeRange = weeklyTimeRange(0);
+        const from = new Date(new Date(timeRange.to).getTime() - 14 * 24 * 60 * 60 * 1000);
+        timeRange = { from: from.toISOString(), to: timeRange.to };
+    }
+    const reviewMembersWithGH = config.team.members.filter((m) => m.github);
+    const reviewUsernames = reviewMembersWithGH.map((m) => m.github);
+    const perMember = await fetchTeamGitHubActivity(reviewGhClient, reviewUsernames, config.github.repos, timeRange);
+    const github = mergeGitHubActivities(perMember, config.team.name, timeRange);
+    let jira;
+    if (reviewJiraClient) {
+        jira = await fetchSprintJiraActivity(reviewJiraClient, sprintName, timeRange);
+    }
+    const dateRange = {
+        from: timeRange.from.split('T')[0],
+        to: timeRange.to.split('T')[0],
+    };
+    const now = new Date();
+    const start = sprintStartDate ? new Date(sprintStartDate) : new Date(timeRange.from);
+    const end = sprintEndDate ? new Date(sprintEndDate) : new Date(timeRange.to);
+    const daysElapsed = Math.max(0, Math.floor((now.getTime() - start.getTime()) / (1000 * 60 * 60 * 24)));
+    const daysTotal = Math.max(1, Math.floor((end.getTime() - start.getTime()) / (1000 * 60 * 60 * 24)));
+    const thresholds = resolveThresholds(config.settings.thresholds);
+    const extras = {};
+    try {
+        const store = new HistoryStore();
+        extras.anomalies = detectAnomalies({
+            pullRequests: github.pullRequests,
+            reviews: github.reviews,
+            jiraIssues: jira?.issues ?? [],
+            memberActivity: buildMemberActivity(perMember),
+            thresholds,
+        });
+        store.close();
+    }
+    catch {
+    }
+    const report = generateSprintReview({ github, jira, sprintName, dateRange, sprintGoal, perMember, daysElapsed, daysTotal }, extras);
     return { content: [{ type: 'text', text: report }] };
 }
 function requireTeamConfig() {
@@ -658,8 +838,9 @@ function buildMemberSnapshots(perMember) {
 function handleGetCapabilities() {
     const configExists = teamConfigExists();
     const config = configExists ? readTeamConfig() : null;
-    const ghCreds = resolveGitHubCredentials();
-    const jiraCreds = resolveJiraCredentials();
+    const authStatuses = getAuthStatuses();
+    const ghStatus = authStatuses.find((s) => s.service === 'github');
+    const jiraStatus = authStatuses.find((s) => s.service === 'jira');
     const parts = [];
     parts.push('# Prodbeam MCP v2');
     parts.push('');
@@ -669,13 +850,17 @@ function handleGetCapabilities() {
     parts.push(`|-----------|--------|`);
     parts.push(`| Config directory | \`${resolveConfigDir()}\` |`);
     parts.push(`| Team config | ${configExists ? `✅ ${config?.team.name} (${config?.team.members.length} members)` : '❌ Not configured'} |`);
-    parts.push(`| GitHub credentials | ${ghCreds ? '✅ Token configured' : '❌ Not configured'} |`);
-    parts.push(`| Jira credentials | ${jiraCreds ? `✅ ${jiraCreds.host}` : '❌ Not configured (optional)'} |`);
+    parts.push(`| GitHub | ${ghStatus?.valid ? `✅ ${ghStatus.method === 'oauth' ? 'OAuth (auto-refresh)' : 'Token configured'}` : `❌ ${ghStatus?.error ?? 'Not configured'}`} |`);
+    parts.push(`| Jira | ${jiraStatus?.valid ? `✅ ${jiraStatus.method === 'oauth' ? 'OAuth (auto-refresh)' : 'Token configured'}` : `❌ ${jiraStatus?.error ?? 'Not configured (optional)'}`} |`);
     parts.push('');
-    if (!ghCreds || !configExists) {
+    if (!ghStatus?.valid || !configExists) {
         parts.push('## Getting Started');
         parts.push('');
-        renderSetupGuide(parts, { ghCreds: !!ghCreds, jiraCreds: !!jiraCreds, configExists });
+        renderSetupGuide(parts, {
+            ghCreds: !!ghStatus?.valid,
+            jiraCreds: !!jiraStatus?.valid,
+            configExists,
+        });
     }
     if (config) {
         parts.push('## Team');
@@ -719,6 +904,7 @@ function handleGetCapabilities() {
     parts.push('- **team_standup** — Full team standup (last 24h)');
     parts.push('- **weekly_summary** — Week-in-review with metrics');
     parts.push('- **sprint_retro** — Sprint retrospective with completion rates');
+    parts.push('- **sprint_review** — Mid-sprint health check with risks and progress');
     return { content: [{ type: 'text', text: parts.join('\n') }] };
 }
 function renderSetupGuide(parts, status) {