@debugg-ai/debugg-ai-mcp 1.0.35 → 1.0.36

package/dist/handlers/testPageChangesHandler.js

@@ -35,10 +35,28 @@ export async function testPageChangesHandler(input, context, progressCallback) {
                 logger.info(`Reusing tunnel: ${ctx.targetUrl} (id: ${ctx.tunnelId})`);
             }
             else {
-                const tunnel = await client.tunnels.provision();
+                let tunnel;
+                try {
+                    tunnel = await client.tunnels.provision();
+                }
+                catch (provisionError) {
+                    const msg = provisionError instanceof Error ? provisionError.message : String(provisionError);
+                    throw new Error(`Failed to provision tunnel for ${ctx.originalUrl}. ` +
+                        `The remote browser needs a secure tunnel to reach your local dev server. ` +
+                        `Make sure your dev server is running on the specified port and try again. ` +
+                        `(Detail: ${msg})`);
+                }
                 keyId = tunnel.keyId;
-                // revokeKey is stored on the TunnelInfo and fires when the tunnel auto-stops.
-                ctx = await ensureTunnel(ctx, tunnel.tunnelKey, tunnel.tunnelId, tunnel.keyId, () => client.revokeNgrokKey(tunnel.keyId));
+                try {
+                    ctx = await ensureTunnel(ctx, tunnel.tunnelKey, tunnel.tunnelId, tunnel.keyId, () => client.revokeNgrokKey(tunnel.keyId));
+                }
+                catch (tunnelError) {
+                    const msg = tunnelError instanceof Error ? tunnelError.message : String(tunnelError);
+                    throw new Error(`Tunnel creation failed for ${ctx.originalUrl}. ` +
+                        `Could not establish a secure connection between the remote browser and your local port. ` +
+                        `Verify your dev server is running and the port is accessible. ` +
+                        `(Detail: ${msg})`);
+                }
                 logger.info(`Tunnel ready: ${ctx.targetUrl} (id: ${ctx.tunnelId})`);
             }
         }

package/dist/tools/testPageChanges.js

@@ -10,7 +10,7 @@ import { testPageChangesHandler } from '../handlers/testPageChangesHandler.js';
 export const testPageChangesTool = {
     name: "check_app_in_browser",
     title: "Run E2E Browser Test",
-    description: "Give an AI agent eyes on a live website or app. The agent browses it, interacts with it, and tells you whether a given task or check passed. Works on localhost or any URL. Use for visual QA, flow validation, regression checks, or anything that needs a real browser to verify.",
+    description: "Give an AI agent eyes on a live website or app. The agent browses it, interacts with it, and tells you whether a given task or check passed. Works on localhost or any URL. Use for visual QA, flow validation, regression checks, or anything that needs a real browser to verify.\n\nLOCALHOST SUPPORT: Pass any localhost URL (e.g. http://localhost:3000) and it Just Works. A secure tunnel is automatically created so the remote browser can reach your local dev server — no manual ngrok setup, no port forwarding, no config. Supports localhost, 127.0.0.1, 0.0.0.0, [::1], and private IPs (192.168.x.x, 10.x.x.x). The tunnel stays alive for 55 minutes and is reused across calls to the same port.",
     inputSchema: {
         type: "object",
         properties: {
@@ -21,7 +21,7 @@ export const testPageChangesTool = {
             },
             url: {
                 type: "string",
-                description: "URL to navigate to. Accepts any URL including localhost (e.g. 'http://localhost:3000', 'https://example.com'). Localhost URLs are automatically tunneled so the remote browser can reach them."
+                description: "URL to navigate to. Can be any public URL (https://example.com) OR a localhost/local dev server URL. For localhost URLs (http://localhost:3000, http://127.0.0.1:8080, etc.), a secure tunnel is automatically created so the remote browser can reach your machine — just make sure your dev server is running on that port. No extra setup needed."
             },
             environmentId: {
                 type: "string",

package/dist/types/index.js

@@ -8,7 +8,7 @@ import { normalizeUrl } from '../utils/urlParser.js';
  */
 export const TestPageChangesInputSchema = z.object({
     description: z.string().min(1, 'Description is required'),
-    url: z.preprocess(normalizeUrl, z.string().url('Must be a valid URL — accepts localhost (e.g. "http://localhost:3000") or any public URL')),
+    url: z.preprocess(normalizeUrl, z.string().url('Invalid URL. Pass a full URL like "http://localhost:3000" or "https://example.com". Localhost URLs are auto-tunneled to the remote browser — no extra setup needed.')),
     // Credential/environment resolution
     environmentId: z.string().uuid().optional(),
     credentialId: z.string().uuid().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@debugg-ai/debugg-ai-mcp",
-  "version": "1.0.35",
+  "version": "1.0.36",
   "description": "Zero-Config, Fully AI-Managed End-to-End Testing for all code gen platforms.",
   "type": "module",
   "bin": {