koalr-mcp 0.4.3 → 0.4.5

package/dist/server.js

@@ -22,6 +22,7 @@ Koalr tracks pull requests, DORA metrics, deploy risk, test coverage, incidents,
 - **Stale/blocked work**: get_at_risk_prs then get_open_prs for detail
 - **Team or repo drill-down**: list_teams → get_team, or list_repositories → get_repository
 - **Individual developer**: get_developer (requires GitHub login) or list_top_contributors
+- **Search by name**: search_koalr to find developers, repos, PRs, or teams by name
 - **Incidents**: list_recent_incidents returns MTTR and impact
 - **Coverage**: get_coverage_summary by repository
 - **AI tool usage**: get_ai_adoption_summary or get_ai_adoption_trend
@@ -36,7 +37,7 @@ score_pr_for_deploy_risk returns 0–100. 0–39 = low, 40–69 = medium, 70–8
 export function createServer(apiKey) {
     const server = new McpServer({
         name: 'koalr',
-        version: '0.4.1',
+        version: '0.4.5',
     }, {
         instructions: SYSTEM_PROMPT,
     });

package/dist/tools/ai-adoption.js

@@ -1,8 +1,16 @@
 import { z } from 'zod/v3';
 import { apiGet, formatResult } from '../client.js';
 export function registerAiAdoptionTools(server, apiKey) {
-    server.tool('get_ai_adoption_summary', 'Get AI coding tool adoption metrics including GitHub Copilot acceptance rate, Cursor active users, AI-generated code percentage, and suggestions per developer. Use this to understand how the team is using AI coding assistants.', {}, { readOnlyHint: true }, async () => {
-        const data = await apiGet('/api/v1/copilot', undefined, apiKey);
+    server.tool('get_ai_adoption_summary', 'Get AI coding tool adoption metrics including GitHub Copilot acceptance rate, Cursor active users, AI-generated code percentage, and suggestions per developer. Use this to understand how the team is using AI coding assistants.', {
+        teamId: z
+            .string()
+            .optional()
+            .describe('Team ID to filter AI adoption metrics to a specific team. Omit for org-wide summary.'),
+    }, { readOnlyHint: true }, async ({ teamId }) => {
+        const params = {};
+        if (teamId)
+            params['teamId'] = teamId;
+        const data = await apiGet('/api/v1/copilot', params, apiKey);
         return { content: [{ type: 'text', text: formatResult(data) }] };
     });
     server.tool('get_ai_adoption_trend', 'Get the trend of AI tool adoption over time showing weekly active users, acceptance rates, and code attribution percentages. Use this to track whether AI tool adoption is growing or declining.', {

package/dist/tools/organization.js

@@ -1,10 +1,18 @@
 import { z } from 'zod/v3';
 import { apiGet, formatResult } from '../client.js';
 export function registerOrganizationTools(server, apiKey) {
-    server.tool('get_org_health', 'Get a comprehensive organization health snapshot: DORA performance tier (Elite/High/Medium/Low), cycle time percentile vs industry benchmarks, test coverage percentage, number of active teams, and incident rate. Use this as the first tool to get a high-level picture of engineering health.', {}, { readOnlyHint: true }, async () => {
+    server.tool('get_org_health', 'Get a comprehensive organization health snapshot: DORA performance tier (Elite/High/Medium/Low), cycle time percentile vs industry benchmarks, test coverage percentage, number of active teams, and incident rate. Use this as the first tool to get a high-level picture of engineering health.', {
+        teamId: z
+            .string()
+            .optional()
+            .describe('Team ID to scope health metrics to a specific team. Omit for org-wide snapshot.'),
+    }, { readOnlyHint: true }, async ({ teamId }) => {
+        const params = {};
+        if (teamId)
+            params['teamId'] = teamId;
         const [doraData, flowData, teamsData] = await Promise.all([
-            apiGet('/api/v1/metrics/dora', undefined, apiKey),
-            apiGet('/api/v1/flow', undefined, apiKey),
+            apiGet('/api/v1/metrics/dora', params, apiKey),
+            apiGet('/api/v1/flow', params, apiKey),
             apiGet('/api/v1/teams', undefined, apiKey),
         ]);
         const result = {

package/dist/tools/pull-requests.js

@@ -30,11 +30,18 @@ export function registerPullRequestTools(server, apiKey) {
         const data = await apiGet('/api/v1/pull-requests', params, apiKey);
         return { content: [{ type: 'text', text: formatResult(data) }] };
     });
-    server.tool('get_at_risk_prs', 'Get pull requests at risk of becoming long-running or blocked. These are PRs that have been open for more than 3 days, have no reviews, or are very large. Use this to prompt engineering leads to take action on blocked work.', {}, { readOnlyHint: true }, async () => {
+    server.tool('get_at_risk_prs', 'Get pull requests at risk of becoming long-running or blocked. These are PRs that have been open for more than 3 days, have no reviews, or are very large. Use this to prompt engineering leads to take action on blocked work.', {
+        repositoryId: z
+            .string()
+            .optional()
+            .describe('Filter to a specific repository by ID. Omit to return at-risk PRs across all repos.'),
+    }, { readOnlyHint: true }, async ({ repositoryId }) => {
         const params = {
             state: 'open',
             highRiskOnly: 'true',
         };
+        if (repositoryId)
+            params['repositoryId'] = repositoryId;
         const data = await apiGet('/api/v1/pull-requests', params, apiKey);
         return { content: [{ type: 'text', text: formatResult(data) }] };
     });

package/dist/tools/search.js

@@ -1,7 +1,7 @@
 import { z } from 'zod/v3';
 import { apiGet, formatResult } from '../client.js';
 export function registerSearchTools(server, apiKey) {
-    server.tool('search', 'Search across all Koalr entities: developers (by name or GitHub login), repositories (by name), pull requests (by title or branch), and teams (by name). Use this when you need to find an entity before using a more specific tool.', {
+    server.tool('search_koalr', 'Search across all Koalr entities: developers (by name or GitHub login), repositories (by name), pull requests (by title or branch), and teams (by name). Use this when you need to find an entity before using a more specific tool.', {
         query: z.string().describe('Search query text (e.g. "payments", "alice", "auth-service")'),
         type: z
             .enum(['developer', 'repository', 'pr', 'team'])

package/dist/tools/teams.js

@@ -1,8 +1,16 @@
 import { z } from 'zod/v3';
 import { apiGet, formatResult } from '../client.js';
 export function registerTeamTools(server, apiKey) {
-    server.tool('list_teams', 'List all engineering teams in the organization with their member counts and slugs. Use this to discover team IDs needed for filtering other metrics tools.', {}, { readOnlyHint: true }, async () => {
-        const data = await apiGet('/api/v1/teams', undefined, apiKey);
+    server.tool('list_teams', 'List all engineering teams in the organization with their member counts and slugs. Use this to discover team IDs needed for filtering other metrics tools.', {
+        search: z
+            .string()
+            .optional()
+            .describe('Filter teams by name substring (case-insensitive). Omit to list all teams.'),
+    }, { readOnlyHint: true }, async ({ search }) => {
+        const params = {};
+        if (search)
+            params['search'] = search;
+        const data = await apiGet('/api/v1/teams', params, apiKey);
         return { content: [{ type: 'text', text: formatResult(data) }] };
     });
     server.tool('get_team', "Get details and metrics for a specific team including DORA performance, cycle time, and member count. Use this when asked about a specific team's engineering health.", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koalr-mcp",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Koalr MCP server — connect engineering metrics to AI agents",
   "type": "module",
   "license": "MIT",