Merge pull request #174 from kernel/hypeship/reduce-mcp-gap-noise

Reduce noisy MCP missing-capability reports

Author: masnwilliams

src/lib/mcp/analytics.test.ts

@@ -615,7 +615,7 @@ describe("captureMcpFeedback", () => {
 describe("instrumentMcpAnalytics (SDK integration)", () => {
   const ORG = "org_integration";
 
-  test("keeps the feedback tool schema stable when analytics is disabled", async () => {
+  test("keeps analytics tool contracts stable", async () => {
     const disabled = await connectTestMcp(
       (server) => instrumentMcpAnalytics(server, null),
       {},
@@ -639,6 +639,19 @@ describe("instrumentMcpAnalytics (SDK integration)", () => {
       expect(disabledTool?.inputSchema).toEqual(enabledTool?.inputSchema);
       expect(disabledTool?.inputSchema.required).toContain("context");
 
+      const missingCapabilityTool = (
+        await enabled.client.listTools()
+      ).tools.find(({ name }) => name === "get_more_tools");
+      expect(missingCapabilityTool?.description).toContain(
+        "only after checking the available tools",
+      );
+      expect(missingCapabilityTool?.description).toContain(
+        "transient failure or capacity limit",
+      );
+      expect(missingCapabilityTool?.description).toContain(
+        "client-side permission restriction",
+      );
+
       const result = await disabled.client.callTool({
         name: KERNEL_FEEDBACK_TOOL_NAME,
         arguments: {

src/lib/mcp/analytics.ts

@@ -311,7 +311,7 @@ const MISSING_CAPABILITY_CONTEXT_DESCRIPTION =
 function registerMissingCapabilityTool(server: McpServer) {
   server.tool(
     MISSING_CAPABILITY_TOOL_NAME,
-    "Check for additional tools whenever your task might benefit from specialized capabilities - even if existing tools could work as a fallback.",
+    "Report a genuine server capability gap only after checking the available tools and confirming none can complete the task. Do not call this for an existing fallback, a transient failure or capacity limit, or a client-side permission restriction; use the available tool or submit_feedback instead.",
     {
       context: z.string().describe(MISSING_CAPABILITY_CONTEXT_DESCRIPTION),
     },