@fouradata/mcp 0.2.11

package/dist/tools/proxy.js

@@ -0,0 +1,379 @@
+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;
+}
+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";
+}
+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}`,
+            },
+        };
+    }
+}
+const PROXY_API_URL = (process.env.FOURA_API_BASE ?? "https://api.foura.ai/api") + "/proxy/";
+const ProxyValidateSchema = 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 (both case-insensitive). Response PASSES if AT LEAST ONE entry matches (header name contains the key AND value contains the value). Checked across all redirect hops. Empty / omitted = no header requirement."),
+        fail: z
+            .record(z.string(), z.string())
+            .optional()
+            .describe("Map of header-name-substring → header-value-substring (both case-insensitive). Response is treated as FAILURE if ANY entry matches a response header. Use to reject challenge / block headers, e.g. {\"x-blocked\": \"bot\", \"server\": \"cloudflare\"}."),
+    })
+        .optional(),
+    data: z
+        .object({
+        accept: z.array(z.string()).optional(),
+        fail: z.array(z.string()).optional(),
+    })
+        .optional(),
+})
+    .optional();
+// Inner DwRequest — matches dwstack types/src/single.ts DwRequestSchema
+// (which is what /api/proxy/ inner.request validates against). Method is
+// permissive z.string() not enum (Bug 9). All optionals match upstream.
+const ProxyInnerRequestSchema = z
+    .object({
+    method: z
+        .string()
+        .min(1)
+        .describe("HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, or any WebDAV verb)"),
+    url: z
+        .string()
+        .url()
+        .describe("Target URL the proxy should fetch. 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/pricing for blocked sites. {ts} placeholder is replaced with current Unix timestamp."),
+    headers: z
+        .array(z.tuple([z.string(), z.string()]))
+        .optional()
+        .describe("Custom HTTP headers as [name, value] tuples. Example: [[\"Referer\", \"https://google.com/\"]]"),
+    unblocker: z
+        .boolean()
+        .optional()
+        .describe("Inject realistic browser headers (User-Agent, Sec-Ch-Ua, Accept-Encoding, …) and make the request look like it's coming from a real browser at the wire level. Default false — STRONGLY recommended on proxy paths since most sites that need a proxy also have wire-level anti-bot (Cloudflare, Akamai, PerimeterX, Datadome). Cheap to leave on for production scrapes."),
+    data: z
+        .union([z.string(), z.record(z.string(), z.unknown())])
+        .optional()
+        .describe("Request body."),
+    timeout_ms: z.number().int().min(0).max(120_000).optional().describe("Per-attempt timeout in ms"),
+    connect_timeout_ms: z.number().int().min(0).max(120_000).optional(),
+    accept_timeout_ms: z.number().int().min(0).max(120_000).optional(),
+    server_response_timeout_ms: z.number().int().min(0).max(120_000).optional(),
+    dns_cache_timeout_sec: z.number().int().min(0).max(240).optional(),
+    followRedirects: z.number().int().min(0).max(20).optional(),
+    tryJsonData: z.boolean().optional(),
+    returnBuffer: z.boolean().optional(),
+    validate: ProxyValidateSchema,
+})
+    .describe("The inner HTTP request to send through each proxy attempt. Validation rules here determine when a proxy is treated as failed and retried.");
+// HeaderInfo[] — same as single. Multi-value headers (Set-Cookie, Link)
+// come as string OR string[] from node-libcurl — Bug 1 fix.
+const ProxyHeaderInfoSchema = 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())]));
+const proxyOutputShape = {
+    // Success — PrResponse = DwResponse + {proxy, total}. The backend type
+    // also has an optional `proxyId` (number), but the api gateway encodes it
+    // into the `proxy` string and strips it from the response. We don't
+    // surface it in outputSchema — zod silently drops any stray copy.
+    status: z.number().int().optional().describe("HTTP status code from the target (from the succeeding proxy attempt). `0` indicates every attempt failed before any HTTP response (DNS / connection refused / timeout) — check the `error` field for the underlying reason."),
+    headers: z
+        .union([z.array(ProxyHeaderInfoSchema), z.string(), z.record(z.string(), z.unknown())])
+        .optional()
+        .describe("Response headers per redirect hop, 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)."),
+    data: z.unknown().optional().describe("Decoded response body. Omitted when offloaded."),
+    // total_time can be string | number | null per dwstack types — Bug 6 fix.
+    total_time: z
+        .union([z.number(), z.string(), z.null()])
+        .optional()
+        .describe("Per-attempt wall-clock duration of the succeeding inner request"),
+    proxy: z
+        .string()
+        .optional()
+        .describe("Base36 ID of the pool exit that succeeded (e.g. `4DZ3VE`). Reuse on next call: " +
+        "pass to foura_single.proxy or foura_browser.proxy → same exit IP. " +
+        "Pass to foura_proxy.ignoreProxies → skip this exit on future rotations."),
+    total: z
+        .number()
+        .optional()
+        .describe("Outer total time in seconds (proxy selection + retries + the successful inner attempt). Float."),
+    // 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 — includes PrResponseError shape: {error, request, total} (no status, no headers, no data)
+    error: z.string().optional().describe("Human-readable error message"),
+    service: z.enum(["single", "proxy", "browser", "api"]).optional(),
+    retryAfter: z.number().optional(),
+    current: z
+        .object({ concurrency: z.number().optional(), rpm: z.number().optional() })
+        .optional(),
+    limits: z
+        .object({ maxConcurrency: z.number().optional(), maxRpm: z.number().optional() })
+        .optional(),
+    request: z.unknown().optional().describe("Echoed PrRequest from upstream PrResponseError"),
+    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 proxyInputShape = {
+    request: ProxyInnerRequestSchema,
+    // PrRequestSchema.timeout_ms is `.positive()` in upstream — 0 is invalid here
+    // (different from single's .min(0)).
+    maxTries: z
+        .number()
+        .int()
+        .min(1)
+        .max(90)
+        .optional()
+        .describe("Maximum proxy rotation attempts before giving up (default 5, max 90). Default 5 is sized for lightly-blocked sites. Raise to 25-30 for tier-1 WAF challenges (Vercel Security Checkpoint, Cloudflare 'Just a moment', Akamai Bot Manager) — most rotations on these targets need this range. If still blocked after 30 attempts, the gate is likely country / ASN allowlist (not solvable by rotation) — pivot strategy instead of climbing to 60."),
+    timeout_ms: z
+        .number()
+        .int()
+        .positive()
+        .max(120_000)
+        .optional()
+        .describe("Overall timeout across all rotation attempts in ms (default 45000, max 120000). Must be positive."),
+    ignoreProxies: z
+        .array(z.string())
+        .optional()
+        .describe("Encoded proxy IDs (base36 strings like \"4DZ3VE\") OR proxy URLs to exclude from rotation. Both forms are accepted."),
+    // Bug 3 fix — opt-in offload, default false (inline).
+    offload_large: z
+        .boolean()
+        .optional()
+        .describe("If true, response bodies >= 50KB are written to disk and returned as a resource_link instead of inlined. Default false."),
+};
+export function registerProxyTool(server) {
+    server.registerTool("foura_proxy", {
+        title: "FourA — HTTP request via rotating proxies",
+        description: "Route an HTTP request through FourA's proxy pool with automatic retry across multiple proxies. " +
+            "Per-host proxy rating picks proxies most likely to succeed for the target. Use when foura_single " +
+            "returns 403, captcha, or geo-blocked content. Typical latency 1–5s. The response includes the " +
+            "encoded proxy ID that succeeded ('proxy' field) — reuse it in foura_single.proxy or " +
+            "foura_browser.proxy to pin follow-up requests to the same exit IP, or pass it in ignoreProxies " +
+            "to skip this exit on the next rotation. Escalate to foura_browser if all proxies fail or the " +
+            "page needs JavaScript rendering. When the trigger is a tier-1 WAF challenge (Vercel Security " +
+            "Checkpoint, Cloudflare 'Just a moment', Akamai Bot Manager), set maxTries to 25-30 — the default " +
+            "5 will usually be too low for these targets. Distinguish from country / ASN allowlist denials " +
+            "(country-licensed bookmakers, government sites): there rotation never helps regardless of " +
+            "maxTries — after ~30 failed attempts on the same block, stop climbing and pivot strategy instead.",
+        inputSchema: proxyInputShape,
+        outputSchema: proxyOutputShape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, async (input) => guardHandler("proxy", z.object(proxyOutputShape), async () => {
+        try {
+            await assertPublicTarget(input.request.url);
+        }
+        catch (e) {
+            if (e instanceof SsrfBlockedError) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: e.message }],
+                    structuredContent: { service: "proxy", code: "ssrf_blocked", error: e.message },
+                };
+            }
+            throw e;
+        }
+        const { offload_large, ...upstreamBody } = input;
+        const res = await request(PROXY_API_URL, {
+            method: "POST",
+            headers: {
+                "X-API-Key": getApiKey(),
+                "Content-Type": "application/json",
+                "User-Agent": "foura-mcp/0.2.11 (proxy)",
+            },
+            body: JSON.stringify(upstreamBody),
+        });
+        const text = await res.body.text();
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `FourA proxy — non-JSON response (${res.statusCode}): ${text.slice(0, 200)}`,
+                    },
+                ],
+                structuredContent: {
+                    service: "proxy",
+                    code: "upstream_non_json",
+                    status: res.statusCode,
+                    error: `Upstream returned non-JSON (${res.statusCode}): ${text.slice(0, 200)}`,
+                },
+            };
+        }
+        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 proxy error ${res.statusCode}: ${errMsg}${retryStr}` }],
+                structuredContent: {
+                    ...e,
+                    service: "proxy",
+                    code: deriveCode(res.statusCode, e),
+                    status: typeof e.status === "number" ? e.status : res.statusCode,
+                },
+            };
+        }
+        const parsedObj = parsed;
+        // Bug 8 fix — all-proxies-fail returns HTTP 200 + PrResponseError shape
+        // {error, request, total}. dwstack proxy/src/api/request.ts:43
+        // forwards without overriding the response status. Without this check,
+        // foura-mcp would silently return "success" with a missing-data body.
+        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 proxy — all attempts failed: ${parsedObj.error}`,
+                    },
+                ],
+                structuredContent: {
+                    ...parsedObj,
+                    service: "proxy",
+                    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 proxyLabel = parsedObj.proxy ? ` · via ${parsedObj.proxy}` : "";
+        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${proxyLabel}` },
+                    { type: "resource_link", uri: stored.uri, name: stored.name, mimeType: stored.mimeType },
+                ],
+                structuredContent: {
+                    status: parsedObj.status,
+                    headers: parsedObj.headers,
+                    total_time: parsedObj.total_time,
+                    proxy: parsedObj.proxy,
+                    total: parsedObj.total,
+                    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${proxyLabel}` }],
+            structuredContent: parsedObj,
+        };
+    }));
+}
+export const __test = { deriveCode, ProxyHeaderInfoSchema, ProxyInnerRequestSchema, proxyInputShape, proxyOutputShape };
+//# sourceMappingURL=proxy.js.map

package/dist/tools/proxy.js.map

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

package/dist/tools/single.d.ts

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+declare function deriveCode(status: number, envelope: Record<string, unknown>): string;
+declare function guardHandler(service: "single" | "proxy" | "browser", outputSchema: z.ZodObject<any>, fn: () => Promise<any>): Promise<any>;
+export declare function registerSingleTool(server: McpServer): void;
+export declare const __test: {
+    deriveCode: typeof deriveCode;
+    HeaderInfoSchema: z.ZodObject<{
+        result: z.ZodOptional<z.ZodObject<{
+            version: z.ZodOptional<z.ZodString>;
+            code: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+    singleInputShape: {
+        method: z.ZodString;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>>>;
+        unblocker: z.ZodOptional<z.ZodBoolean>;
+        data: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+        proxy: z.ZodOptional<z.ZodString>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+        connect_timeout_ms: z.ZodOptional<z.ZodNumber>;
+        accept_timeout_ms: z.ZodOptional<z.ZodNumber>;
+        server_response_timeout_ms: z.ZodOptional<z.ZodNumber>;
+        dns_cache_timeout_sec: z.ZodOptional<z.ZodNumber>;
+        followRedirects: z.ZodOptional<z.ZodNumber>;
+        tryJsonData: z.ZodOptional<z.ZodBoolean>;
+        returnBuffer: z.ZodOptional<z.ZodBoolean>;
+        validate: z.ZodOptional<z.ZodObject<{
+            status: z.ZodOptional<z.ZodObject<{
+                accept: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                fail: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            }, z.core.$strip>>;
+            headers: z.ZodOptional<z.ZodObject<{
+                accept: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                fail: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>>;
+            data: z.ZodOptional<z.ZodObject<{
+                accept: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                fail: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        offload_large: z.ZodOptional<z.ZodBoolean>;
+    };
+    singleOutputShape: {
+        status: z.ZodOptional<z.ZodNumber>;
+        headers: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+            result: z.ZodOptional<z.ZodObject<{
+                version: z.ZodOptional<z.ZodString>;
+                code: z.ZodOptional<z.ZodNumber>;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>>, z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+        data: z.ZodOptional<z.ZodUnknown>;
+        total_time: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodNull]>>;
+        offloaded_resource_uri: z.ZodOptional<z.ZodString>;
+        size_bytes: z.ZodOptional<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+        service: z.ZodOptional<z.ZodEnum<{
+            single: "single";
+            proxy: "proxy";
+            browser: "browser";
+            api: "api";
+        }>>;
+        retryAfter: z.ZodOptional<z.ZodNumber>;
+        current: z.ZodOptional<z.ZodObject<{
+            concurrency: z.ZodOptional<z.ZodNumber>;
+            rpm: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        limits: z.ZodOptional<z.ZodObject<{
+            maxConcurrency: z.ZodOptional<z.ZodNumber>;
+            maxRpm: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        code: z.ZodOptional<z.ZodString>;
+    };
+    guardHandler: typeof guardHandler;
+};
+export {};