@zenrows/mcp 2.0.3 → 2.0.5

package/dist/http.js

@@ -5,6 +5,9 @@ import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/
 import { createServer } from "./server.js";
 // ─── app ──────────────────────────────────────────────────────────────────────
 const app = new Hono();
+// Cache MCP client name per API key across invocations.
+// Populated from the clientInfo field in MCP initialize requests.
+const mcpClientCache = new Map();
 // CORS — required for browser-side MCP clients (Claude.ai, Cursor web, etc.)
 // All origins allowed: the API key is the auth mechanism, not the origin.
 app.use(cors({
@@ -93,9 +96,17 @@ app.all("/mcp", async (c) => {
         sessionIdGenerator: undefined, // stateless — no session tracking between requests
         enableJsonResponse: true, // return JSON instead of SSE (simpler for Lambda + most MCP clients)
     });
-    const server = createServer(apiKey);
+    // Use cached client name from a prior initialize request (stateless transport
+    // creates a new server per request, so getClientVersion() is only set during
+    // the initialize request itself, not during subsequent tool calls).
+    const server = createServer(apiKey, mcpClientCache.get(apiKey));
     await server.connect(transport);
     const response = await transport.handleRequest(c.req.raw);
+    // If this was an initialize request, getClientVersion() is now set — cache it
+    // so subsequent tool call requests can include x-mcp-client-name.
+    const resolvedName = server.server.getClientVersion()?.name;
+    if (resolvedName)
+        mcpClientCache.set(apiKey, resolvedName);
     await transport.close();
     return response;
 });

package/dist/server.d.ts

@@ -1,2 +1,2 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function createServer(apiKey: string): McpServer;
+export declare function createServer(apiKey: string, clientName?: string): McpServer;

package/dist/server.js

@@ -8,11 +8,14 @@ const ZENROWS_API_URL = "https://api.zenrows.com/v1/";
 const DEFAULT_JS_RENDER = process.env.ZENROWS_JS_RENDER === "true";
 const DEFAULT_PREMIUM_PROXY = process.env.ZENROWS_PREMIUM_PROXY === "true";
 const DEFAULT_RESPONSE_TYPE = process.env.ZENROWS_RESPONSE_TYPE ?? "markdown";
-export function createServer(apiKey) {
+export function createServer(apiKey, clientName) {
     const server = new McpServer({
         name: "zenrows",
         version: pkg.version,
     });
+    // Resolve client name: prefer explicit value (HTTP stateless path),
+    // fall back to MCP handshake (stdio/persistent connection path).
+    const getClientName = () => clientName ?? server.server.getClientVersion()?.name;
     // ─── scrape ────────────────────────────────────────────────────────────────
     server.registerTool("scrape", {
         annotations: {
@@ -164,7 +167,11 @@ Examples:
         let response;
         try {
             response = await fetch(`${ZENROWS_API_URL}?${searchParams}`, {
-                headers: { "User-Agent": `zenrows/mcp ${pkg.version}` },
+                headers: {
+                    "User-Agent": `zenrows/mcp ${pkg.version}`,
+                    ...(getClientName() ? { "x-mcp-client-name": getClientName() } : {}),
+                    "x-mcp-tool": "scrape",
+                },
             });
         }
         catch (err) {
@@ -261,6 +268,6 @@ Examples:
         ],
     }));
     const BROWSER_URL = process.env.ZENROWS_BROWSER_URL ?? "https://mcp.zenrows.com";
-    registerBrowserTools(server, apiKey, BROWSER_URL);
+    registerBrowserTools(server, apiKey, BROWSER_URL, getClientName);
     return server;
 }

package/dist/tools/browser-fetch.d.ts

@@ -3,5 +3,5 @@ export interface BrowserFetchResult {
     status: number;
     data: unknown;
 }
-export declare function browserFetch(method: string, path: string, apiKey: string, browserUrl: string, body?: unknown): Promise<BrowserFetchResult>;
+export declare function browserFetch(method: string, path: string, apiKey: string, browserUrl: string, body?: unknown, clientName?: string, toolName?: string): Promise<BrowserFetchResult>;
 export declare function browserError(result: BrowserFetchResult): string;

package/dist/tools/browser-fetch.js

@@ -1,9 +1,15 @@
 const REQUEST_TIMEOUT_MS = 35_000;
-export async function browserFetch(method, path, apiKey, browserUrl, body) {
+export async function browserFetch(method, path, apiKey, browserUrl, body, clientName, toolName) {
     const url = `${browserUrl.replace(/\/$/, "")}${path}`;
+    const headers = {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json",
+        ...(clientName ? { "x-mcp-client-name": clientName } : {}),
+        ...(toolName ? { "x-mcp-tool": toolName } : {}),
+    };
     const init = {
         method,
-        headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+        headers,
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
     };
     if (body !== undefined) {

package/dist/tools/browser.d.ts

@@ -1,2 +1,2 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerBrowserTools(server: McpServer, apiKey: string, browserUrl: string): void;
+export declare function registerBrowserTools(server: McpServer, apiKey: string, browserUrl: string, getClientName: () => string | undefined): void;

package/dist/tools/browser.js

@@ -10,8 +10,8 @@ function json(data) {
     return { content: [{ type: "text", text: JSON.stringify(data) }] };
 }
 const sessionId = z.string().describe("Session ID returned by browser_navigate");
-export function registerBrowserTools(server, apiKey, browserUrl) {
-    const fetch = (method, path, body) => browserFetch(method, path, apiKey, browserUrl, body);
+export function registerBrowserTools(server, apiKey, browserUrl, getClientName) {
+    const tfetch = (toolName) => (method, path, body) => browserFetch(method, path, apiKey, browserUrl, body, getClientName(), toolName);
     // ─── Session ─────────────────────────────────────────────────────────────
     server.registerTool("browser_navigate", {
         annotations: { title: "Open Browser & Navigate", readOnlyHint: false, destructiveHint: false },
@@ -35,6 +35,7 @@ When to use options:
             proxy_region: z.string().optional().describe("World region code for geo-targeted proxy (eu=Europe, na=North America, ap=Asia Pacific, sa=South America, af=Africa, me=Middle East)"),
         },
     }, async (params) => {
+        const fetch = tfetch("browser_navigate");
         let result;
         try {
             result = await fetch("POST", "/browser/sessions", {
@@ -69,6 +70,7 @@ When to use options:
         description: "Close a browser session and free all associated resources. Always call this when done to release the browser slot.",
         inputSchema: { session_id: sessionId },
     }, async ({ session_id }) => {
+        const fetch = tfetch("browser_close");
         try {
             const result = await fetch("DELETE", `/browser/sessions/${session_id}`);
             if (!result.ok)
@@ -85,6 +87,7 @@ When to use options:
         description: "Navigate back to the previous page in the browser history.",
         inputSchema: { session_id: sessionId },
     }, async ({ session_id }) => {
+        const fetch = tfetch("browser_go_back");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/go_back`);
             if (!result.ok)
@@ -100,6 +103,7 @@ When to use options:
         description: "Navigate forward to the next page in the browser history.",
         inputSchema: { session_id: sessionId },
     }, async ({ session_id }) => {
+        const fetch = tfetch("browser_go_forward");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/go_forward`);
             if (!result.ok)
@@ -115,6 +119,7 @@ When to use options:
         description: "Reload the current page.",
         inputSchema: { session_id: sessionId },
     }, async ({ session_id }) => {
+        const fetch = tfetch("browser_reload");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/reload`);
             if (!result.ok)
@@ -134,6 +139,7 @@ When to use options:
             selector: z.string().describe("CSS selector of the element to click"),
         },
     }, async ({ session_id, selector }) => {
+        const fetch = tfetch("browser_click");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/click`, { selector });
             if (!result.ok)
@@ -152,6 +158,7 @@ When to use options:
             selector: z.string().describe("CSS selector of the element to hover over"),
         },
     }, async ({ session_id, selector }) => {
+        const fetch = tfetch("browser_hover");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/hover`, { selector });
             if (!result.ok)
@@ -172,6 +179,7 @@ When to use options:
             clear_first: z.boolean().optional().describe("Clear existing content before typing (default false)"),
         },
     }, async ({ session_id, selector, text, clear_first }) => {
+        const fetch = tfetch("browser_type");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/type`, { selector, text, clear_first });
             if (!result.ok)
@@ -191,6 +199,7 @@ When to use options:
             value: z.string().describe("Value to fill in"),
         },
     }, async ({ session_id, selector, value }) => {
+        const fetch = tfetch("browser_fill");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/fill`, { selector, value });
             if (!result.ok)
@@ -210,6 +219,7 @@ When to use options:
             value: z.string().describe("Value of the option to select"),
         },
     }, async ({ session_id, selector, value }) => {
+        const fetch = tfetch("browser_select_option");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/select`, { selector, value });
             if (!result.ok)
@@ -228,6 +238,7 @@ When to use options:
             selector: z.string().describe("CSS selector of the checkbox or radio element"),
         },
     }, async ({ session_id, selector }) => {
+        const fetch = tfetch("browser_check");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/check`, { selector });
             if (!result.ok)
@@ -246,6 +257,7 @@ When to use options:
             selector: z.string().describe("CSS selector of the checkbox element"),
         },
     }, async ({ session_id, selector }) => {
+        const fetch = tfetch("browser_uncheck");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/uncheck`, { selector });
             if (!result.ok)
@@ -264,6 +276,7 @@ When to use options:
             selector: z.string().describe("CSS selector of the element to focus"),
         },
     }, async ({ session_id, selector }) => {
+        const fetch = tfetch("browser_focus");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/focus`, { selector });
             if (!result.ok)
@@ -282,6 +295,7 @@ When to use options:
             key: z.string().describe('Key to press (e.g. "Enter", "Tab", "Escape", "ArrowDown", "Control+a")'),
         },
     }, async ({ session_id, key }) => {
+        const fetch = tfetch("browser_press_key");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/press_key`, { key });
             if (!result.ok)
@@ -301,6 +315,7 @@ When to use options:
             distance: z.number().int().positive().optional().describe("Pixels to scroll (default 500)"),
         },
     }, async ({ session_id, direction, distance }) => {
+        const fetch = tfetch("browser_scroll");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/scroll`, { direction, distance });
             if (!result.ok)
@@ -320,6 +335,7 @@ When to use options:
             target_selector: z.string().describe("CSS selector of the drop target"),
         },
     }, async ({ session_id, source_selector, target_selector }) => {
+        const fetch = tfetch("browser_drag");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/drag`, {
                 source_selector,
@@ -346,6 +362,7 @@ The tree shows all interactive elements (buttons, inputs, links) with their role
 labels, and states — everything needed to drive browser interactions.`,
         inputSchema: { session_id: sessionId },
     }, async ({ session_id }) => {
+        const fetch = tfetch("browser_get_accessibility_tree");
         try {
             const result = await fetch("GET", `/browser/sessions/${session_id}/accessibility_tree`);
             if (!result.ok)
@@ -362,6 +379,7 @@ labels, and states — everything needed to drive browser interactions.`,
         description: "Get the current URL of the browser session.",
         inputSchema: { session_id: sessionId },
     }, async ({ session_id }) => {
+        const fetch = tfetch("browser_get_url");
         try {
             const result = await fetch("GET", `/browser/sessions/${session_id}/url`);
             if (!result.ok)
@@ -377,6 +395,7 @@ labels, and states — everything needed to drive browser interactions.`,
         description: "Get the title of the current page.",
         inputSchema: { session_id: sessionId },
     }, async ({ session_id }) => {
+        const fetch = tfetch("browser_get_title");
         try {
             const result = await fetch("GET", `/browser/sessions/${session_id}/title`);
             if (!result.ok)
@@ -395,6 +414,7 @@ labels, and states — everything needed to drive browser interactions.`,
             selector: z.string().optional().describe("CSS selector of the element (omit for full page body text)"),
         },
     }, async ({ session_id, selector }) => {
+        const fetch = tfetch("browser_get_text");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/get_text`, { selector });
             if (!result.ok)
@@ -415,6 +435,7 @@ labels, and states — everything needed to drive browser interactions.`,
             attribute: z.string().describe("Attribute name to retrieve (e.g. 'href', 'src', 'data-id')"),
         },
     }, async ({ session_id, selector, attribute }) => {
+        const fetch = tfetch("browser_get_attribute");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/get_attribute`, { selector, attribute });
             if (!result.ok)
@@ -433,6 +454,7 @@ labels, and states — everything needed to drive browser interactions.`,
             selector: z.string().optional().describe("CSS selector of the element (omit for full page HTML)"),
         },
     }, async ({ session_id, selector }) => {
+        const fetch = tfetch("browser_get_html");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/get_html`, { selector });
             if (!result.ok)
@@ -452,6 +474,7 @@ labels, and states — everything needed to drive browser interactions.`,
             selector: z.string().describe("CSS selector to query"),
         },
     }, async ({ session_id, selector }) => {
+        const fetch = tfetch("browser_query_selector_all");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/query_selector_all`, { selector });
             if (!result.ok)
@@ -475,6 +498,7 @@ labels, and states — everything needed to drive browser interactions.`,
                 .describe("CSS selector to capture only a specific element (overrides full_page)"),
         },
     }, async ({ session_id, full_page, selector }) => {
+        const fetch = tfetch("browser_screenshot");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/screenshot`, { full_page, selector });
             if (!result.ok)
@@ -504,6 +528,7 @@ labels, and states — everything needed to drive browser interactions.`,
             scale: z.number().min(0.1).max(2).optional().describe("Page scale factor (default 1)"),
         },
     }, async ({ session_id, print_background, landscape, scale }) => {
+        const fetch = tfetch("browser_generate_pdf");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/generate_pdf`, { print_background, landscape, scale });
             if (!result.ok)
@@ -536,6 +561,7 @@ labels, and states — everything needed to drive browser interactions.`,
             visible: z.boolean().optional().describe("Also require the element to be visible, not just present in the DOM (default false)"),
         },
     }, async ({ session_id, selector, visible }) => {
+        const fetch = tfetch("browser_wait_for_selector");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/wait_for_selector`, { selector, visible });
             if (!result.ok)
@@ -554,6 +580,7 @@ labels, and states — everything needed to drive browser interactions.`,
             timeout_ms: z.number().int().min(1000).max(60000).optional().describe("How long to wait in milliseconds (default 30000, max 60000)"),
         },
     }, async ({ session_id, timeout_ms }) => {
+        const fetch = tfetch("browser_wait_for_navigation");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/wait_for_navigation`, timeout_ms ? { timeout_ms } : undefined);
             if (!result.ok)
@@ -572,6 +599,7 @@ labels, and states — everything needed to drive browser interactions.`,
             ms: z.number().int().min(0).max(30000).describe("Milliseconds to wait (max 30000)"),
         },
     }, async ({ session_id, ms }) => {
+        const fetch = tfetch("browser_wait");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/wait`, { ms });
             if (!result.ok)
@@ -591,6 +619,7 @@ labels, and states — everything needed to drive browser interactions.`,
             script: z.string().describe("JavaScript expression or function body to evaluate in the page context"),
         },
     }, async ({ session_id, script }) => {
+        const fetch = tfetch("browser_evaluate");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/evaluate`, { script });
             if (!result.ok)
@@ -607,6 +636,7 @@ labels, and states — everything needed to drive browser interactions.`,
         description: "Get all cookies for the current page.",
         inputSchema: { session_id: sessionId },
     }, async ({ session_id }) => {
+        const fetch = tfetch("browser_get_cookies");
         try {
             const result = await fetch("GET", `/browser/sessions/${session_id}/cookies`);
             if (!result.ok)
@@ -635,6 +665,7 @@ labels, and states — everything needed to drive browser interactions.`,
                 .describe("Array of cookie objects to set"),
         },
     }, async ({ session_id, cookies }) => {
+        const fetch = tfetch("browser_set_cookies");
         try {
             // Remap http_only → httpOnly to match Chrome DevTools Protocol / Rod's JSON field names.
             const mapped = cookies.map(({ http_only, ...rest }) => ({ ...rest, httpOnly: http_only }));
@@ -652,6 +683,7 @@ labels, and states — everything needed to drive browser interactions.`,
         description: "Clear all cookies for the current browser session.",
         inputSchema: { session_id: sessionId },
     }, async ({ session_id }) => {
+        const fetch = tfetch("browser_clear_cookies");
         try {
             const result = await fetch("DELETE", `/browser/sessions/${session_id}/cookies`);
             if (!result.ok)
@@ -673,6 +705,7 @@ labels, and states — everything needed to drive browser interactions.`,
             value: z.string().optional().describe("Value to store (required for set)"),
         },
     }, async ({ session_id, action, key, value }) => {
+        const fetch = tfetch("browser_local_storage");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/local_storage`, { action, key, value });
             if (!result.ok)
@@ -692,6 +725,7 @@ labels, and states — everything needed to drive browser interactions.`,
             url: z.string().url().optional().describe("URL to open in the new tab (opens blank tab if omitted)"),
         },
     }, async ({ session_id, url }) => {
+        const fetch = tfetch("browser_new_tab");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/new_tab`, { url });
             if (!result.ok)
@@ -710,6 +744,7 @@ labels, and states — everything needed to drive browser interactions.`,
             tab_id: z.string().describe("Tab ID returned by browser_new_tab"),
         },
     }, async ({ session_id, tab_id }) => {
+        const fetch = tfetch("browser_switch_tab");
         try {
             const result = await fetch("POST", `/browser/sessions/${session_id}/switch_tab`, { tab_id });
             if (!result.ok)
@@ -750,7 +785,7 @@ labels, and states — everything needed to drive browser interactions.`,
         z.object({ type: z.literal("wait"), ms: z.number().int().min(0).max(30000) }),
         z.object({ type: z.literal("evaluate"), script: z.string() }),
     ]);
-    async function runAction(action, session_id) {
+    async function runAction(action, session_id, fetch) {
         const sid = session_id;
         switch (action.type) {
             case "navigate": {
@@ -938,11 +973,12 @@ For proper image rendering, use browser_screenshot directly.`,
             stop_on_error: z.boolean().optional().describe("Stop executing on the first failed action (default true)"),
         },
     }, async ({ session_id, actions, stop_on_error = true }) => {
+        const fetch = tfetch("browser_batch");
         const results = [];
         for (let i = 0; i < actions.length; i++) {
             const action = actions[i];
             try {
-                const result = await runAction(action, session_id);
+                const result = await runAction(action, session_id, fetch);
                 results.push({ step: i, type: action.type, result });
             }
             catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenrows/mcp",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "ZenRows MCP server — Universal Scraper API for AI coding assistants",
   "type": "module",
   "bin": {