docs: expose unstable mode in mcp tools

packages/mcp-server/test/protocol.test.ts

@@ -54,3 +54,102 @@ describe("MCP protocol cookie inputs", () => {
     expect(String(calledUrl)).not.toContain("cookies=");
   });
 });
+
+describe("MCP protocol unstableFilter", () => {
+  beforeEach(() => {
+    global.fetch = mock(() =>
+      Promise.resolve(new Response(JSON.stringify([]), { status: 200 })),
+    ) as typeof fetch;
+  });
+
+  afterEach(() => {
+    global.fetch = originalFetch;
+  });
+
+  test("all search tools should document the unstableFilter property", () => {
+    const toolNames = ["search_kijiji", "search_facebook", "search_ebay"];
+    for (const toolName of toolNames) {
+      const tool = tools.find((t) => t.name === toolName);
+      expect(tool).toBeDefined();
+      expect(tool?.inputSchema.properties).toHaveProperty("unstableFilter");
+      const prop = tool?.inputSchema.properties.unstableFilter as any;
+      expect(prop.type).toBe("boolean");
+      expect(prop.description).toContain("optional");
+      expect(prop.description).toContain("20%");
+      expect(prop.description).toContain("median");
+      expect(prop.description).toContain("unstableResults");
+    }
+  });
+
+  test("handler should forward unstableFilter=true for search_kijiji", async () => {
+    await handleMcpRequest(
+      new Request("http://localhost", {
+        method: "POST",
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "tools/call",
+          params: {
+            name: "search_kijiji",
+            arguments: {
+              query: "laptop",
+              unstableFilter: true,
+            },
+          },
+        }),
+      }),
+    );
+
+    const calledUrl = (global.fetch as ReturnType<typeof mock>).mock
+      .calls[0]?.[0];
+    expect(String(calledUrl)).toContain("unstableFilter=true");
+  });
+
+  test("handler should forward unstableFilter=true for search_facebook", async () => {
+    await handleMcpRequest(
+      new Request("http://localhost", {
+        method: "POST",
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "tools/call",
+          params: {
+            name: "search_facebook",
+            arguments: {
+              query: "laptop",
+              unstableFilter: true,
+            },
+          },
+        }),
+      }),
+    );
+
+    const calledUrl = (global.fetch as ReturnType<typeof mock>).mock
+      .calls[0]?.[0];
+    expect(String(calledUrl)).toContain("unstableFilter=true");
+  });
+
+  test("handler should forward unstableFilter=true for search_ebay", async () => {
+    await handleMcpRequest(
+      new Request("http://localhost", {
+        method: "POST",
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "tools/call",
+          params: {
+            name: "search_ebay",
+            arguments: {
+              query: "laptop",
+              unstableFilter: true,
+            },
+          },
+        }),
+      }),
+    );
+
+    const calledUrl = (global.fetch as ReturnType<typeof mock>).mock
+      .calls[0]?.[0];
+    expect(String(calledUrl)).toContain("unstableFilter=true");
+  });
+});