@fouradata/mcp 0.2.11 → 0.3.1

package/dist/tools/auto.js

@@ -0,0 +1,409 @@
+import { request } from "undici";
+import { z } from "zod";
+import { getApiKey } from "../auth.js";
+import { assertPublicTarget, SsrfBlockedError } from "../safe-target.js";
+import { storePayload, THRESHOLD_BYTES } from "../resources.js";
+function extractContentTypeFromHeaderInfo(headers) {
+    if (!Array.isArray(headers))
+        return null;
+    for (const h of headers) {
+        if (h && typeof h === "object") {
+            const entries = Object.entries(h);
+            for (const [k, v] of entries) {
+                if (k.toLowerCase() === "content-type") {
+                    const value = Array.isArray(v) ? v[0] : v;
+                    if (typeof value === "string")
+                        return value.split(";")[0]?.trim() ?? null;
+                }
+            }
+        }
+    }
+    return null;
+}
+// Derive a stable error code from upstream HTTP status + envelope.
+// LLM agents read `code` for retry / classify logic without parsing prose.
+// Same code set as the other three tools - auto reuses them verbatim.
+function deriveCode(status, envelope) {
+    if (status === 400)
+        return "bad_request";
+    if (status === 401)
+        return "auth_failed";
+    if (status === 403)
+        return "forbidden";
+    if (status === 404)
+        return "not_found";
+    if (status === 429)
+        return "rate_limited";
+    if (status === 503) {
+        if (envelope.current)
+            return "at_capacity";
+        const err = typeof envelope.error === "string" ? envelope.error : "";
+        if (err.toLowerCase().includes("disabled"))
+            return "service_disabled";
+        return "service_unavailable";
+    }
+    if (status >= 500)
+        return "upstream_error";
+    if (status >= 400)
+        return "upstream_client_error";
+    return "upstream_unknown";
+}
+// /api/auto is registered on the gateway WITHOUT a trailing slash (the route is
+// an exact `POST /api/auto`), unlike /single/ /proxy/ /browser/ which keep the
+// slash. Hitting `/auto/` would miss the dedicated handler and fall through to
+// the transparent table - so this URL must stay slash-less.
+const AUTO_API_URL = (process.env.FOURA_API_BASE ?? "https://api.foura.ai/api") + "/auto";
+// The client's success criteria, passed verbatim to auto's internal sub-calls.
+// Same DwValidate shape as foura_single / foura_proxy - auto enforces it on
+// every rung itself, so a rung that only superficially "succeeds" (e.g. a
+// challenge interstitial) is rejected and the ladder keeps climbing.
+const AutoValidateSchema = z
+    .object({
+    status: z
+        .object({
+        accept: z.array(z.number().int()).optional().describe("HTTP status codes to treat as success"),
+        fail: z.array(z.number().int()).optional().describe("HTTP status codes to treat as failure"),
+    })
+        .optional(),
+    headers: z
+        .object({
+        accept: z
+            .record(z.string(), z.string())
+            .optional()
+            .describe("Map of header-name-substring → header-value-substring (case-insensitive). PASSES if at least one entry matches a response header."),
+        fail: z
+            .record(z.string(), z.string())
+            .optional()
+            .describe("Map of header-name-substring → header-value-substring (case-insensitive). FAILS if any entry matches a response header (use to reject challenge / block headers)."),
+    })
+        .optional(),
+    data: z
+        .object({
+        accept: z.array(z.string()).optional().describe("Substrings the final body MUST contain for the fetch to count as solved (CASE-SENSITIVE). Strongly recommended on protected targets so auto can tell a real page from a challenge page."),
+        fail: z.array(z.string()).optional().describe("Substrings the final body must NOT contain"),
+    })
+        .optional(),
+})
+    .optional();
+// Response headers come back as an array of per-hop objects (same shape the
+// other tools surface). `result` carries the status line; every other key is a
+// response header name → value (string, or array of strings for multi-value
+// headers like Set-Cookie / Link).
+const HeaderInfoSchema = z
+    .object({
+    result: z
+        .object({
+        version: z.string().optional(),
+        code: z.number().int().optional(),
+        reason: z.string().optional(),
+    })
+        .optional(),
+})
+    .catchall(z.union([z.string(), z.array(z.string())]));
+// The trace auto always returns: which rung delivered, whether a defense was
+// solved, how many sub-call attempts it took, and the summed credits.
+const AutoMetaSchema = z
+    .object({
+    rung: z.string().optional().describe("Which rung delivered the content (e.g. probe / proxy / browser / cache). `cache` means a warm session was replayed cheaply."),
+    solved: z.boolean().optional().describe("True when a bot-defense was actively solved on the way to the content (vs. the target being open)."),
+    attempts: z.number().optional().describe("Total internal sub-call attempts across the whole ladder."),
+    credits: z.number().optional().describe("Total credits spent (sum of every internal sub-call). A cold solve is expensive; a subsequent warm replay amortizes to the cheap-fetch cost."),
+})
+    .catchall(z.unknown());
+// The {proxy, cookies, userAgent} session triple. proxy is the OPAQUE base36
+// proxy id (never a raw IP). Returned by default so a power client can DIY-replay
+// the same session through foura_single / foura_proxy later.
+const AutoSessionSchema = z
+    .object({
+    proxy: z.string().optional().describe("Opaque base36 exit id of the session (e.g. `4DZ3VE`) - pass to foura_single.proxy / foura_proxy.proxy to replay through the same exit. Never a raw IP."),
+    cookies: z.unknown().optional().describe("Cookies accumulated by the winning session - replay them on a follow-up request."),
+    userAgent: z.string().optional().describe("User-Agent string the winning session used - send the same one when replaying."),
+})
+    .catchall(z.unknown());
+const autoOutputShape = {
+    // Success path - single-shaped body so any client that renders foura_single
+    // also renders auto. Note: NO `total_time` (auto does not surface it).
+    status: z
+        .number()
+        .int()
+        .optional()
+        .describe("HTTP status code from the target on the rung that delivered the content. `0` indicates the whole ladder failed before any HTTP response - check `error`."),
+    headers: z
+        .union([z.array(HeaderInfoSchema), z.string(), z.record(z.string(), z.unknown())])
+        .optional()
+        .describe("Response headers from the delivering rung, as an array of objects. Each entry has `result.{version, code, reason}` plus arbitrary header-name keys whose values are strings (or arrays of strings for multi-value headers like Set-Cookie / Link). Last array entry is the final response."),
+    data: z
+        .unknown()
+        .optional()
+        .describe("Decoded response body of the delivered page. String by default; object when the body parsed as JSON. Omitted when offloaded."),
+    meta: AutoMetaSchema.optional().describe("Trace of what the ladder did: rung, solved, attempts, credits. Always present."),
+    session: AutoSessionSchema.optional().describe("The {proxy, cookies, userAgent} triple of the winning session, for DIY replay through foura_single / foura_proxy. Present by default (send returnSession:false to omit)."),
+    // Offload path - MCP layer adds these when body >= 50KB AND offload_large=true
+    offloaded_resource_uri: z.string().optional().describe("foura-mcp://payload/<uuid>"),
+    size_bytes: z.number().int().optional().describe("Total offloaded body size in bytes"),
+    // Error path - auto failure surfaces the failure status + message + attempts.
+    error: z.string().optional().describe("Human-readable error message when the ladder could not deliver the content within the budget."),
+    attempts: z.number().optional().describe("Total sub-call attempts when the ladder failed (also present inside `meta`)."),
+    service: z.enum(["single", "proxy", "browser", "api", "auto"]).optional(),
+    retryAfter: z.number().optional().describe("Seconds to wait before retrying (429/503 from the gateway)"),
+    current: z
+        .object({ concurrency: z.number().optional(), rpm: z.number().optional() })
+        .optional()
+        .describe("Caller's current usage at error time"),
+    limits: z
+        .object({ maxConcurrency: z.number().optional(), maxRpm: z.number().optional() })
+        .optional()
+        .describe("Per-service limits at error time"),
+    code: z
+        .string()
+        .optional()
+        .describe("Stable error code for retry classification. One of: ssrf_blocked, upstream_non_json, output_validation_failed, bad_request (400), auth_failed (401), forbidden (403), not_found (404), rate_limited (429), at_capacity (503), service_disabled (503), service_unavailable (503), upstream_error (>=500), upstream_client_error (other 4xx), upstream_unknown (defensive)."),
+};
+const autoInputShape = {
+    url: z
+        .string()
+        .url()
+        .describe("Target URL. Public hosts only - private/reserved ranges (RFC 1918 10/8, 172.16/12, 192.168/16, loopback 127/8, link-local, IPv6 ULA fc00::/7, IPv6 loopback ::1, plus *.local mDNS) are refused with code `ssrf_blocked`. Example: https://example.com/page. Use {ts} anywhere in the URL to insert the current Unix timestamp for cache-bust."),
+    method: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("HTTP method for the target request (default GET)."),
+    headers: z
+        .array(z.tuple([z.string(), z.string()]))
+        .optional()
+        .describe("Custom HTTP headers to send to the TARGET, as [name, value] tuples. Example: [[\"Accept\", \"application/json\"], [\"Authorization\", \"Bearer ...\"]]"),
+    data: z
+        .union([z.string(), z.record(z.string(), z.unknown())])
+        .optional()
+        .describe("Request body for non-GET methods. Strings sent as-is; objects auto-serialized to JSON."),
+    validate: AutoValidateSchema,
+    returnSession: z
+        .boolean()
+        .optional()
+        .describe("Return the {proxy, cookies, userAgent} session triple of the winning session so you can replay it through foura_single / foura_proxy later. Default true. Send false for a leaner response when you only need the content."),
+    forceProxy: z
+        .boolean()
+        .optional()
+        .describe("Always reach the target through a rotating proxy, never from FourA's own egress. Default true (the target never sees FourA's origin IP). Send false to allow the cheaper direct path - but note some trust-gated defenses actually resolve more easily from the direct egress, so forcing a proxy can make those targets harder (more attempts / credits)."),
+    timeout_ms: z
+        .number()
+        .int()
+        .min(5_000)
+        .max(180_000)
+        .optional()
+        .describe("Total time budget in ms for the WHOLE operation - auto fires several internal attempts and they must all fit inside this. Default 120000, max 180000. Auto portions the budget across its attempts; it does not hand the whole budget to one attempt."),
+    ignoreProxies: z
+        .array(z.string())
+        .optional()
+        .describe("Exits to AVOID - base36 proxy ids (like \"4DZ3VE\") or proxy URLs. Auto skips a warm session on one of these and tells its internal proxy search to avoid them too. Use to rotate away from an exit that just got blocked."),
+    followRedirects: z
+        .number()
+        .int()
+        .min(0)
+        .max(20)
+        .optional()
+        .describe("Follow up to N redirects on the cheap (direct / proxy) rungs so a 301/302 lands on the real content instead of being returned as-is. Default 5; 0 = don't follow. The browser rung follows redirects natively."),
+    // Bug 3 parity - opt-in offload. Default false → response inline regardless of
+    // size so clients that can't read resource_link blocks still get usable output.
+    offload_large: z
+        .boolean()
+        .optional()
+        .describe("If true, response bodies >= 50KB are written to disk and returned as a resource_link instead of inlined. Saves token context but requires a client that supports `resources/read`. Default false."),
+};
+// Convert any handler-level crash OR output-validation failure into the
+// documented {service, code, error} envelope (same guard as the other tools).
+async function guardHandler(service, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+outputSchema, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+fn) {
+    try {
+        const result = await fn();
+        if (result?.structuredContent) {
+            const parsed = outputSchema.safeParse(result.structuredContent);
+            if (!parsed.success) {
+                const issues = parsed.error.issues.slice(0, 5).map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `FourA ${service} - upstream response failed schema: ${issues}` }],
+                    structuredContent: {
+                        service,
+                        code: "output_validation_failed",
+                        error: `Upstream response did not match the expected schema: ${issues}`,
+                    },
+                };
+            }
+        }
+        return result;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            isError: true,
+            content: [{ type: "text", text: `FourA ${service} - internal error: ${msg}` }],
+            structuredContent: {
+                service,
+                code: "output_validation_failed",
+                error: `Tool handler crashed before producing a response: ${msg}`,
+            },
+        };
+    }
+}
+export function registerAutoTool(server) {
+    server.registerTool("foura_auto", {
+        title: "FourA - auto (smart fetch, picks the method for you)",
+        description: "Give a URL, get the content back. The default first choice for any page when you just want " +
+            "the data and don't want to decide how to fetch it. Internally it walks a cost-aware ladder - a " +
+            "fast direct request first, then a rotating proxy, then a full browser session - escalating only " +
+            "as far as the target forces it, solving common bot challenges (Cloudflare, and similar) on the " +
+            "way, and cheaply replaying a warm session on repeat calls to the same host. It learns the right " +
+            "settings per host on its own, so there are no maxTries / pool / retry knobs to tune. " +
+            "Pass `validate` (a substring the real page must contain) on protected targets so it can tell a " +
+            "real page from a challenge page. The response includes a `meta` trace (which rung delivered, " +
+            "credits spent) and, by default, the winning `session` ({proxy, cookies, userAgent}) so you can " +
+            "replay it through foura_single / foura_proxy afterwards. " +
+            "Use one of the lower-level tools instead only when you need explicit control: foura_single for a " +
+            "specific raw HTTP request, foura_proxy to drive the rotation/exit yourself, foura_browser for a " +
+            "scripted browser session.",
+        inputSchema: autoInputShape,
+        outputSchema: autoOutputShape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, async (input) => guardHandler("auto", z.object(autoOutputShape), async () => {
+        try {
+            await assertPublicTarget(input.url);
+        }
+        catch (e) {
+            if (e instanceof SsrfBlockedError) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: e.message }],
+                    structuredContent: { service: "auto", code: "ssrf_blocked", error: e.message },
+                };
+            }
+            throw e;
+        }
+        // Strip MCP-layer-only fields before forwarding upstream.
+        const { offload_large, ...upstreamBody } = input;
+        // auto can run up to its 180s budget; give undici a generous ceiling so it
+        // never cuts the orchestrator short (the server-side budget is the real cap).
+        const res = await request(AUTO_API_URL, {
+            method: "POST",
+            headers: {
+                "X-API-Key": getApiKey(),
+                "Content-Type": "application/json",
+                "User-Agent": "foura-mcp/0.3.1 (auto)",
+            },
+            body: JSON.stringify(upstreamBody),
+            headersTimeout: 200_000,
+            bodyTimeout: 200_000,
+        });
+        const text = await res.body.text();
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `FourA auto - non-JSON response (${res.statusCode}): ${text.slice(0, 200)}`,
+                    },
+                ],
+                structuredContent: {
+                    service: "auto",
+                    code: "upstream_non_json",
+                    status: res.statusCode,
+                    error: `Upstream returned non-JSON (${res.statusCode}): ${text.slice(0, 200)}`,
+                },
+            };
+        }
+        // Gateway-level error (rate limit / auth / capacity) - auto itself ALWAYS
+        // replies transport-200, so a non-2xx transport status is the gateway
+        // rejecting before auto ran. Surface it like the other tools do.
+        if (res.statusCode < 200 || res.statusCode >= 300) {
+            const e = parsed;
+            const errMsg = typeof e.error === "string" ? e.error : "Unknown";
+            const retryStr = typeof e.retryAfter === "number" ? ` · retry ${e.retryAfter}s` : "";
+            return {
+                isError: true,
+                content: [{ type: "text", text: `FourA auto error ${res.statusCode}: ${errMsg}${retryStr}` }],
+                structuredContent: {
+                    ...e,
+                    service: "auto",
+                    code: deriveCode(res.statusCode, e),
+                    status: typeof e.status === "number" ? e.status : res.statusCode,
+                },
+            };
+        }
+        const parsedObj = parsed;
+        // auto returns transport-200; the real verdict is in the body. The
+        // PRIMARY error signal is a non-empty `error` (the ladder failed). A
+        // non-2xx body.status WITHOUT an error is a legitimate success (the
+        // client's validate accepted that status), so it is NOT an error.
+        if (typeof parsedObj.error === "string" && parsedObj.error.length > 0) {
+            const innerStatus = typeof parsedObj.status === "number" ? parsedObj.status : 0;
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `FourA auto - could not deliver content (status ${innerStatus}): ${parsedObj.error}`,
+                    },
+                ],
+                structuredContent: {
+                    ...parsedObj,
+                    service: "auto",
+                    code: innerStatus > 0 ? deriveCode(innerStatus, parsedObj) : "upstream_error",
+                    status: innerStatus,
+                },
+            };
+        }
+        const data = parsedObj.data;
+        let bodyStr = null;
+        if (typeof data === "string")
+            bodyStr = data;
+        else if (data && typeof data === "object")
+            bodyStr = JSON.stringify(data);
+        const statusLabel = parsedObj.status ?? "?";
+        const meta = (parsedObj.meta ?? {});
+        const rungLabel = meta.rung ? ` · ${meta.rung}` : "";
+        const creditLabel = typeof meta.credits === "number" ? ` · ${meta.credits}cr` : "";
+        const shouldOffload = offload_large === true
+            && bodyStr
+            && Buffer.byteLength(bodyStr, "utf8") >= THRESHOLD_BYTES;
+        if (shouldOffload && bodyStr) {
+            const ct = extractContentTypeFromHeaderInfo(parsedObj.headers) ?? "text/plain";
+            const stored = await storePayload(bodyStr, ct, "response-body");
+            const sizeKb = (stored.size / 1024).toFixed(1);
+            return {
+                content: [
+                    { type: "text", text: `${statusLabel} · offloaded ${sizeKb} KB${rungLabel}${creditLabel}` },
+                    { type: "resource_link", uri: stored.uri, name: stored.name, mimeType: stored.mimeType },
+                ],
+                structuredContent: {
+                    status: parsedObj.status,
+                    headers: parsedObj.headers,
+                    meta: parsedObj.meta,
+                    session: parsedObj.session,
+                    offloaded_resource_uri: stored.uri,
+                    size_bytes: stored.size,
+                },
+            };
+        }
+        const sizeKb = bodyStr ? (Buffer.byteLength(bodyStr, "utf8") / 1024).toFixed(1) : "0";
+        return {
+            content: [{ type: "text", text: `${statusLabel} OK · ${sizeKb} KB${rungLabel}${creditLabel}` }],
+            structuredContent: parsedObj,
+        };
+    }));
+}
+// Export internals for unit tests + schema-parity checks.
+export const __test = { deriveCode, HeaderInfoSchema, AutoValidateSchema, autoInputShape, autoOutputShape, guardHandler, AUTO_API_URL };
+//# sourceMappingURL=auto.js.map

package/dist/tools/auto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.js","sourceRoot":"","sources":["../../src/tools/auto.ts"],"names":[],"mappings":"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"}

package/dist/tools/browser.d.ts

@@ -34,6 +34,7 @@ export declare const __test: {
         timeout_ms: z.ZodOptional<z.ZodNumber>;
         checkStatus: z.ZodOptional<z.ZodNumber>;
         checkText: z.ZodOptional<z.ZodString>;
+        unblocker: z.ZodOptional<z.ZodBoolean>;
         offload_large: z.ZodOptional<z.ZodBoolean>;
     };
     browserOutputShape: {

package/dist/tools/browser.js

@@ -53,7 +53,7 @@ fn) {
                 const issues = parsed.error.issues.slice(0, 5).map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
                 return {
                     isError: true,
-                    content: [{ type: "text", text: `FourA ${service} — upstream response failed schema: ${issues}` }],
+                    content: [{ type: "text", text: `FourA ${service} - upstream response failed schema: ${issues}` }],
                     structuredContent: {
                         service,
                         code: "output_validation_failed",
@@ -68,7 +68,7 @@ fn) {
         const msg = e instanceof Error ? e.message : String(e);
         return {
             isError: true,
-            content: [{ type: "text", text: `FourA ${service} — internal error: ${msg}` }],
+            content: [{ type: "text", text: `FourA ${service} - internal error: ${msg}` }],
             structuredContent: {
                 service,
                 code: "output_validation_failed",
@@ -83,8 +83,8 @@ const BrowserCookieInputSchema = z.object({
     value: z.string(),
     domain: z.string().optional(),
 });
-// Full CDP cookie object — captured from Chrome via Network.getAllCookies after navigation.
-// Permissive — Protocol.Network.Cookie has more fields than we model, and CDP versions vary.
+// Full CDP cookie object - captured from Chrome via Network.getAllCookies after navigation.
+// Permissive - Protocol.Network.Cookie has more fields than we model, and CDP versions vary.
 const CdpCookieSchema = z
     .object({
     name: z.string(),
@@ -100,10 +100,10 @@ const CdpCookieSchema = z
 })
     .catchall(z.unknown());
 const browserOutputShape = {
-    // Success — dwstack browser DwResponse (packages/browser/src/schema.ts:19-26)
-    status: z.number().int().optional().describe("HTTP status code from the target page. `0` indicates the navigation failed before any HTTP response (DNS / connection refused / timeout) — check the `error` field for the underlying reason."),
+    // Success - dwstack browser DwResponse (packages/browser/src/schema.ts:19-26)
+    status: z.number().int().optional().describe("HTTP status code from the target page. `0` indicates the navigation failed before any HTTP response (DNS / connection refused / timeout) - check the `error` field for the underlying reason."),
     // CDP headers (Protocol.Network.Headers) are a Record but values can be
-    // string OR string[] in some CDP versions. Bug 11 fix — permissive.
+    // string OR string[] in some CDP versions. Bug 11 fix - permissive.
     headers: z
         .record(z.string(), z.unknown())
         .optional()
@@ -115,7 +115,7 @@ const browserOutputShape = {
         .describe("Fully-rendered page content. String HTML when content-type is HTML; object when the page returned JSON and it was auto-parsed. Field is named `body`, not `data`. Omitted when offloaded."),
     cookies: z.array(CdpCookieSchema).optional().describe("Full cookie objects collected after navigation (name, value, domain, path, expires, httpOnly, secure, session, sameSite, …)"),
     userAgent: z.string().optional().describe("The User-Agent the browser session presented"),
-    // Offload path — MCP layer adds these when body >= 50KB AND offload_large=true
+    // Offload path - MCP layer adds these when body >= 50KB AND offload_large=true
     offloaded_resource_uri: z.string().optional().describe("foura-mcp://payload/<uuid>"),
     size_bytes: z.number().int().optional().describe("Total offloaded body size in bytes"),
     // Error path
@@ -131,7 +131,7 @@ const browserOutputShape = {
     code: z.string().optional().describe("Stable error code for retry classification. One of: ssrf_blocked, upstream_non_json, output_validation_failed, bad_request (400), auth_failed (401), forbidden (403), not_found (404), rate_limited (429), at_capacity (503), service_disabled (503), service_unavailable (503), upstream_error (>=500), upstream_client_error (other 4xx), upstream_unknown (defensive)."),
 };
 const browserInputShape = {
-    url: z.string().url().describe("Target URL to load in a full browser session. Public hosts only — private/reserved ranges (RFC 1918 + loopback + link-local + IPv6 ULA/loopback + *.local mDNS) are refused with code `ssrf_blocked`. Example: https://shop.example.com/product/123 or any single-page-app URL."),
+    url: z.string().url().describe("Target URL to load in a full browser session. Public hosts only - private/reserved ranges (RFC 1918 + loopback + link-local + IPv6 ULA/loopback + *.local mDNS) are refused with code `ssrf_blocked`. Example: https://shop.example.com/product/123 or any single-page-app URL."),
     headers: z
         .record(z.string(), z.string())
         .optional()
@@ -145,7 +145,7 @@ const browserInputShape = {
         .string()
         .optional()
         .describe("Optional proxy. Three forms: (1) URL `http://user:pass@host:port` or `socks5://host:port`; " +
-        "(2) base36 ID from foura_proxy (e.g. `4DZ3VE`) — same pool exit IP; (3) omit → fixed container egress."),
+        "(2) base36 ID from foura_proxy (e.g. `4DZ3VE`) - same pool exit IP; (3) omit → fixed container egress."),
     timeout_ms: z
         .number()
         .int()
@@ -161,8 +161,12 @@ const browserInputShape = {
     checkText: z
         .string()
         .optional()
-        .describe("One-shot post-render validator — substring search on the rendered HTML AFTER navigation completes. NOT a waiter: does not poll, does not block until the substring appears. If the substring is missing, the tool returns an error envelope. Use to catch silent failures like a 200 response that captured a challenge page or empty SPA shell. Example: \"add to cart\" for product pages."),
-    // Bug 3 fix — opt-in offload, default false (inline).
+        .describe("One-shot post-render validator - substring search on the rendered HTML AFTER navigation completes. NOT a waiter: does not poll, does not block until the substring appears. If the substring is missing, the tool returns an error envelope. Use to catch silent failures like a 200 response that captured a challenge page or empty SPA shell. Example: \"add to cart\" for product pages."),
+    unblocker: z
+        .boolean()
+        .optional()
+        .describe("Actively SOLVE an anti-bot / captcha challenge (Cloudflare Turnstile and similar) encountered during navigation, instead of just rendering it. Default true. Set false to render and return the page exactly as it loads - including a challenge page - without attempting to solve; cheaper when you already know the target is open or you want the raw challenge page."),
+    // Bug 3 fix - opt-in offload, default false (inline).
     offload_large: z
         .boolean()
         .optional()
@@ -170,20 +174,21 @@ const browserInputShape = {
 };
 export function registerBrowserTool(server) {
     server.registerTool("foura_browser", {
-        title: "FourA — full browser navigation",
-        description: "Load a URL in a real browser session. JS runs, DOM renders, cookies come back. 2–10s. " +
+        title: "FourA - full browser navigation",
+        description: "Load a URL in a real browser session. JS runs, DOM renders, cookies come back. 2-10s. " +
             "Use for SPAs, lazy-loaded content, or JS anti-bot challenges (Cloudflare Turnstile etc.). " +
             "Prefer foura_single for static HTML; foura_proxy for static pages where your IP is blocked. " +
             "To rotate the browser's exit IP: call foura_proxy first, pass its returned `proxy` ID into " +
-            "this tool's `proxy` field — the browser exits through that pool IP. Default (no `proxy`) " +
+            "this tool's `proxy` field - the browser exits through that pool IP. Default (no `proxy`) " +
             "is one fixed container egress. If the target is behind a tier-1 WAF challenge (Vercel / " +
             "Cloudflare / Akamai), calling this tool directly will usually still capture the challenge " +
-            "page rather than the post-challenge content — the snapshot fires before the challenge's " +
+            "page rather than the post-challenge content - the snapshot fires before the challenge's " +
             "deferred reload completes. Correct chain: call foura_proxy first with maxTries:25-30 against " +
             "the same URL → take the returned proxy base36 ID → pass it into this tool's `proxy` field. " +
             "The browser then exits through the IP that already cleared the challenge for this target. " +
-            "No `unblocker` flag — browser navigation already sends real browser headers by default, so " +
-            "the flag would be redundant.",
+            "By default the browser actively solves an anti-bot / captcha challenge it meets along the way " +
+            "(the `unblocker` flag, default true); set `unblocker:false` to skip solving and return the " +
+            "page exactly as it loads, challenge page included.",
         inputSchema: browserInputShape,
         outputSchema: browserOutputShape,
         annotations: {
@@ -211,7 +216,7 @@ export function registerBrowserTool(server) {
             headers: {
                 "X-API-Key": getApiKey(),
                 "Content-Type": "application/json",
-                "User-Agent": "foura-mcp/0.2.11 (browser)",
+                "User-Agent": "foura-mcp/0.3.1 (browser)",
             },
             body: JSON.stringify(upstreamBody),
         });
@@ -226,7 +231,7 @@ export function registerBrowserTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: `FourA browser — non-JSON response (${res.statusCode}): ${text.slice(0, 200)}`,
+                        text: `FourA browser - non-JSON response (${res.statusCode}): ${text.slice(0, 200)}`,
                     },
                 ],
                 structuredContent: {
@@ -253,7 +258,7 @@ export function registerBrowserTool(server) {
             };
         }
         const parsedObj = parsed;
-        // Bug 8 fix — browser request.ts also rejects with DwResponseError on
+        // Bug 8 fix - browser request.ts also rejects with DwResponseError on
         // page failure (timeout, navigation error, checkStatus mismatch).
         // Service forwards as 200 + {error, ...} via dwRequestToExpressRes.
         if (typeof parsedObj.error === "string" && parsedObj.error.length > 0) {
@@ -263,7 +268,7 @@ export function registerBrowserTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: `FourA browser — page failure (status ${innerStatus}): ${parsedObj.error}`,
+                        text: `FourA browser - page failure (status ${innerStatus}): ${parsedObj.error}`,
                     },
                 ],
                 structuredContent: {