Connect AI agents to the ZenRows MCP server

Vendor MCP

The ZenRows MCP connector routes your AI agent's tool calls to ZenRows's own MCP server through Scalekit. Each user signs in to ZenRows once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 43 tools.

Tools: 43
What they doRead · write · destructive: 18 · 24 · 118 read24 write1 destructive
Users sign in with: OAuth
OAuth app: Scalekit's or your own

What you can do

Scrape webpages: fetch any page as clean markdown, with JavaScript rendering and premium proxies when needed
Extract structured data: pull products, articles, or listings from a page as JSON fields
Drive a live browser: open pages, click, type, fill forms, scroll, and switch tabs in a browser session
Capture page content: get the visible text, HTML, a screenshot, or a PDF render of the current page
Run batch jobs: submit many URLs at once, check job status, cancel runs, and download the results

Setup

Install the SDK
- Node.js
- Python
Terminal window
npm install @scalekit-sdk/node dotenv
Terminal window
pip install scalekit-sdk-python python-dotenv
Set your credentials
Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```
Create the ZenRows MCP connection
In AgentKit > Connections, create a ZenRows MCP connection. The name you give it is the connection_name your code passes. See Configure connections.
Scalekit credentials are available for ZenRows MCP server, so you don't need to register an OAuth app.

Authorize a user and make your first call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'zenrowsmcp'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize ZenRows MCP:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'zenrowsmcp_batch_results',
27
  toolInput: { job_id: 'YOUR_JOB_ID' },
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "zenrowsmcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize ZenRows MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={"job_id":"YOUR_JOB_ID"},
27
    tool_name="zenrowsmcp_batch_results",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool

Try in Playground Request a tool

zenrowsmcp_batch_resultsList result rows for a ZenRows Batch job.Read-only
Batch Results
List result rows for a ZenRows Batch job. Each row may include task_id, external_id, status, and a short-lived result_url; download soon as presigned links expire.
Inputs
job_idstringrequired
Batch job id.
statusstring
Filter results by status (default: all).one of successfulfailedall
zenrowsmcp_batch_statusGet status and stats for a ZenRows Batch job, including latest_run.status and latest_run.stats.Read-only
Batch Status
Get status and stats for a ZenRows Batch job, including latest_run.status and latest_run.stats.
Inputs
job_idstringrequired
Batch job id returned by batch_create.
zenrowsmcp_batch_waitPoll batch_status until a ZenRows Batch job reaches a terminal state (completed, stopped, or deleted).Read-only
Batch Wait
Poll batch_status until a ZenRows Batch job reaches a terminal state (completed, stopped, or deleted).
Inputs
job_idstringrequired
Batch job id.
timeout_msinteger
Max wait time in milliseconds (default 600000).
zenrowsmcp_browser_generate_pdfRender the current page as a PDF document.Read-only
Browser Generate Pdf
Render the current page as a PDF document.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
landscapeboolean
Render PDF in landscape orientation (default false).
print_backgroundboolean
Include CSS background graphics in the PDF (default false).
scalenumber
Page scale factor for PDF rendering, 0.1–2 (default 1).
zenrowsmcp_browser_get_accessibility_treeReturn the accessibility tree of the current page for element discovery and screen-reader testing.Read-only
Browser Get Accessibility Tree
Return the accessibility tree of the current page for element discovery and screen-reader testing.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_get_attributeGet the value of a specific HTML attribute from an element matching a CSS selector.Read-only
Browser Get Attribute
Get the value of a specific HTML attribute from an element matching a CSS selector.
Inputs
attributestringrequired
HTML attribute name to read, e.g. href, src, data-id.
selectorstringrequired
CSS selector identifying the target element, e.g. #submit-button or .product-card.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_get_cookiesReturn all cookies set in the current browser session.Read-only
Browser Get Cookies
Return all cookies set in the current browser session.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_get_htmlReturn the outer HTML of an element or the full page if no selector is given.Read-only
Browser Get Html
Return the outer HTML of an element or the full page if no selector is given.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
selectorstring
CSS selector identifying the target element, e.g. #submit-button or .product-card.
zenrowsmcp_browser_get_textReturn the visible text content of an element or the full page if no selector is given.Read-only
Browser Get Text
Return the visible text content of an element or the full page if no selector is given.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
selectorstring
CSS selector identifying the target element, e.g. #submit-button or .product-card.
zenrowsmcp_browser_get_titleReturn the current page title.Read-only
Browser Get Title
Return the current page title.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_get_urlReturn the current page URL.Read-only
Browser Get Url
Return the current page URL.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_query_selector_allReturn all elements matching a CSS selector as an array of handles.Read-only
Browser Query Selector All
Return all elements matching a CSS selector as an array of handles.
Inputs
selectorstringrequired
CSS selector identifying the target element, e.g. #submit-button or .product-card.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_screenshotCapture a screenshot of the current page or a specific element.Read-only
Browser Screenshot
Capture a screenshot of the current page or a specific element.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
full_pageboolean
Capture the full scrollable page, not just the visible viewport.
selectorstring
CSS selector identifying the target element, e.g. #submit-button or .product-card.
zenrowsmcp_browser_waitPause execution for a specified number of milliseconds.Read-only
Browser Wait
Pause execution for a specified number of milliseconds.
Inputs
msintegerrequired
Milliseconds to pause execution.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_wait_for_navigationWait for a page navigation to complete after triggering a link or form submission.Read-only
Browser Wait For Navigation
Wait for a page navigation to complete after triggering a link or form submission.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
timeout_msinteger
Maximum milliseconds to wait before timing out.
zenrowsmcp_browser_wait_for_selectorWait until an element matching a CSS selector appears in the DOM.Read-only
Browser Wait For Selector
Wait until an element matching a CSS selector appears in the DOM.
Inputs
selectorstringrequired
CSS selector identifying the target element, e.g. #submit-button or .product-card.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
visibleboolean
If true, wait until the element is visible in the viewport; if false, wait until present in DOM.
zenrowsmcp_extractExtract structured data from a webpage using ZenRows.Read-only
Extract
Extract structured data from a webpage using ZenRows. Prefer this over scrape when you need JSON fields (products, articles, listings) rather than a full page body. Supports auto (site-tailored Extract, open beta), autoparse (general-purpose), or css (explicit selector map) modes.
Inputs
urlstringrequired
The webpage URL to extract data from.
css_extractorstring
Required when mode=css. JSON map of field to selector, e.g. {"title":"h1","price":".price"}.
fallback_autoparseboolean
When mode=auto and the domain is not in the Extract open beta, retry once with autoparse.default true
js_renderboolean
Enable headless JavaScript rendering for SPAs and dynamically loaded content.
modestring
Extraction mode: 'auto' (default, site-tailored Extract), 'autoparse' (general-purpose JSON), or 'css' (requires css_extractor).one of autoautoparsecssdefault auto
mode_autoboolean
Enable Adaptive Stealth Mode (mode=auto) for tougher, anti-bot-protected sites.
premium_proxyboolean
Use premium residential proxies to bypass anti-bot protection. Higher credit cost.
proxy_countrystring
ISO 3166-1 alpha-2 country code for geo-targeted proxy. Requires premium_proxy or mode_auto.
waitinteger
Milliseconds to wait after page load before extracting. Max 30000. Requires js_render.
wait_forstring
CSS selector to wait for before extracting. Requires js_render.
zenrowsmcp_scrapeScrape any webpage and return its content using ZenRows.Read-only
Scrape
Scrape any webpage and return its content using ZenRows. Returns clean markdown by default; supports JavaScript rendering, premium proxies, CSS extraction, and structured output.
Inputs
urlstringrequired
Full URL to navigate to or scrape (must include scheme, e.g. https://).
autoparseboolean
Automatically extract structured data from the page into JSON. Best for product pages, articles, and listings.
css_extractorstring
CSS selector map for targeted extraction, e.g. {"title":"h1","price":".price-tag"}. Returns JSON instead of full page content.
js_instructionsstring
JSON array of browser interactions before scraping, e.g. [{"click":"#load-more"},{"wait":1000}]. Requires js_render=true.
js_renderboolean
Enable headless JavaScript rendering. Required for SPAs (React, Vue, Angular) and dynamically loaded content.default false
outputsstring
Comma-separated data types to extract as structured JSON: emails, headings, links, menus, images, videos, audios. Use * for all.
premium_proxyboolean
Use premium residential proxies to bypass heavy anti-bot protection. Higher credit cost.default false
proxy_countrystring
ISO 3166-1 alpha-2 country code for geo-targeted proxy, e.g. US, GB, DE.
response_typestring
Output format. 'markdown' (default) preserves structure and is ideal for LLMs. 'plaintext' strips all formatting for pure text extraction. 'pdf' returns a PDF of the page. 'html' returns the raw HTML source (omits the response_type param; ZenRows default). Ignored when autoparse, css_extractor, outputs, or screenshot params are set.one of markdownplaintextpdfhtmldefault markdown
screenshotboolean
Capture an above-the-fold screenshot instead of text content.
screenshot_fullpageboolean
Capture a full-page screenshot including content below the fold.
screenshot_selectorstring
Capture a screenshot of a specific element by CSS selector instead of the full page.
waitinteger
Milliseconds to wait after page load before capturing. Max 30000. Requires js_render=true.
wait_forstring
CSS selector to wait for before capturing. Requires js_render=true.
zenrowsmcp_batch_createSubmit a cloud Batch job that fans out many URLs asynchronously (ZenRows Batch API, beta).Write
Batch Create
Submit a cloud Batch job that fans out many URLs asynchronously (ZenRows Batch API, beta). Not the same as browser_batch. Returns a job_id and latest_run status/stats; poll with batch_status or batch_wait, then fetch rows with batch_results.
Inputs
js_renderboolean
Job-level js_render applied to all tasks.
premium_proxyboolean
Job-level premium_proxy applied to all tasks.
proxy_countrystring
Job-level ISO 3166-1 alpha-2 country code. Requires premium_proxy or mode=auto.
response_typestring
Job-level response_type applied to all tasks.one of markdownplaintexthtmlpdf
tasksarray
List of tasks, each needing a url. Prefer this over urls when you need per-task params.
urlsarray
Shorthand list of URLs, converted to tasks. Ignored when tasks is provided.
waitboolean
If true, poll until the job reaches a terminal state before returning.
wait_timeout_msinteger
Max wait time in milliseconds when wait=true (default 600000).
zenrows_paramsobject
Additional job-level zenrows_params merged with the flags above.
zenrowsmcp_browser_batchExecute a sequence of browser actions in a single call against an existing session.Write
Browser Batch
Execute a sequence of browser actions in a single call against an existing session. Actions run sequentially and stop at the first failure unless stop_on_error is false.
Inputs
actionsarrayrequired
Ordered list of actions to perform. Each action has a 'type' field plus type-specific parameters.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
stop_on_errorboolean
If true (default), stop executing actions when one fails. Set false to continue on errors.
zenrowsmcp_browser_checkCheck a checkbox or radio button by CSS selector.Write
Browser Check
Check a checkbox or radio button by CSS selector.
Inputs
selectorstringrequired
CSS selector identifying the target element, e.g. #submit-button or .product-card.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_clear_cookiesClear all cookies for the current browser session.Write
Browser Clear Cookies
Clear all cookies for the current browser session.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_clickClick an element identified by a CSS selector.Write
Browser Click
Click an element identified by a CSS selector.
Inputs
selectorstringrequired
CSS selector identifying the target element, e.g. #submit-button or .product-card.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_closeClose a browser session and free its resources.Write
Browser Close
Close a browser session and free its resources. Always call this when done to avoid session leaks.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_dragDrag an element from a source to a target CSS selector.Write
Browser Drag
Drag an element from a source to a target CSS selector.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
source_selectorstringrequired
CSS selector for the element to drag from.
target_selectorstringrequired
CSS selector for the element to drop onto.
zenrowsmcp_browser_evaluateExecute a JavaScript expression in the page context and return its result.Write
Browser Evaluate
Execute a JavaScript expression in the page context and return its result.
Inputs
scriptstringrequired
JavaScript expression to evaluate in the page context. Return value is serialized to JSON.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_fillFill an input, textarea, or contenteditable element with text.Write
Browser Fill
Fill an input, textarea, or contenteditable element with text.
Inputs
selectorstringrequired
CSS selector identifying the target element, e.g. #submit-button or .product-card.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
valuestringrequired
Text value to set (fill) or option value to select.
zenrowsmcp_browser_focusMove keyboard focus to an element identified by a CSS selector.Write
Browser Focus
Move keyboard focus to an element identified by a CSS selector.
Inputs
selectorstringrequired
CSS selector identifying the target element, e.g. #submit-button or .product-card.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_go_backNavigate to the previous page in the browser history.Write
Browser Go Back
Navigate to the previous page in the browser history.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_go_forwardNavigate to the next page in the browser history.Write
Browser Go Forward
Navigate to the next page in the browser history.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_hoverMove the mouse pointer over an element identified by a CSS selector.Write
Browser Hover
Move the mouse pointer over an element identified by a CSS selector.
Inputs
selectorstringrequired
CSS selector identifying the target element, e.g. #submit-button or .product-card.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_local_storageRead, write, or clear localStorage in the current page context.Write
Browser Local Storage
Read, write, or clear localStorage in the current page context.
Inputs
actionstringrequired
Operation: get a value, set a value, or clear allone of getsetclear
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
keystring
localStorage key to read or write.
valuestring
Text value to set (fill) or option value to select.
zenrowsmcp_browser_navigateOpen a ZenRows browser session and navigate to a URL.Write
Browser Navigate
Open a ZenRows browser session and navigate to a URL. Returns a session_id required by all subsequent browser_* tools; always call browser_close when done.
Inputs
urlstringrequired
Full URL to navigate to or scrape (must include scheme, e.g. https://).
proxy_countrystring
ISO 3166-1 alpha-2 country code for geo-targeted proxy, e.g. US, GB, DE.
proxy_regionstring
World region for geo-targeted proxy: eu, na, ap, sa, af, or me.
zenrowsmcp_browser_new_tabOpen a new browser tab and navigate to a URL in the current session.Write
Browser New Tab
Open a new browser tab and navigate to a URL in the current session.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
urlstring
Full URL to navigate to or scrape (must include scheme, e.g. https://).
zenrowsmcp_browser_press_keySimulate pressing a keyboard key, optionally combined with modifier keys.Write
Browser Press Key
Simulate pressing a keyboard key, optionally combined with modifier keys.
Inputs
keystringrequired
localStorage key to read or write.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_reloadReload the current page.Write
Browser Reload
Reload the current page.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_scrollScroll the page in a given direction by a specified pixel distance.Write
Browser Scroll
Scroll the page in a given direction by a specified pixel distance.
Inputs
directionstringrequired
Scroll directionone of updownleftright
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
distanceinteger
Pixels to scroll (default 500).
zenrowsmcp_browser_select_optionSelect an option in a <select> element by value or label.Write
Browser Select Option
Select an option in a <select> element by value or label.
Inputs
selectorstringrequired
CSS selector identifying the target element, e.g. #submit-button or .product-card.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
valuestringrequired
Text value to set (fill) or option value to select.
zenrowsmcp_browser_set_cookiesSet one or more cookies in the current browser session.Write
Browser Set Cookies
Set one or more cookies in the current browser session.
Inputs
cookiesarrayrequired
Array of cookie objects to set. Each object requires name and value; domain, path, expires, secure, and http_only are optional.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_browser_switch_tabSwitch focus to a different tab in the current session by tab ID.Write
Browser Switch Tab
Switch focus to a different tab in the current session by tab ID.
Inputs
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
tab_idstringrequired
Numeric tab ID returned by browser_new_tab.
zenrowsmcp_browser_typeType text into the focused element character by character, simulating real keyboard input.Write
Browser Type
Type text into the focused element character by character, simulating real keyboard input.
Inputs
selectorstringrequired
CSS selector identifying the target element, e.g. #submit-button or .product-card.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
textstringrequired
Text to type character by character into the focused element.
clear_firstboolean
If true, clear the existing field value before typing.
zenrowsmcp_browser_uncheckUncheck a checkbox identified by a CSS selector.Write
Browser Uncheck
Uncheck a checkbox identified by a CSS selector.
Inputs
selectorstringrequired
CSS selector identifying the target element, e.g. #submit-button or .product-card.
session_idstringrequired
Session ID returned by browser_navigate. Required by all browser_* tools.
zenrowsmcp_batch_cancelStop an in-flight ZenRows Batch job run.Destructive
Batch Cancel
Stop an in-flight ZenRows Batch job run.
Inputs
job_idstringrequired
Batch job id to stop.

What you can do

Setup

Install the SDK

Set your credentials

Create the ZenRows MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

Batch Results

Inputs

Batch Status

Inputs

Batch Wait

Inputs

Browser Generate Pdf

Inputs

Browser Get Accessibility Tree

Inputs

Browser Get Attribute

Inputs

Browser Get Cookies

Inputs

Browser Get Html

Inputs

Browser Get Text

Inputs

Browser Get Title

Inputs

Browser Get Url

Inputs

Browser Query Selector All

Inputs

Browser Screenshot

Inputs

Browser Wait

Inputs

Browser Wait For Navigation

Inputs

Browser Wait For Selector

Inputs

Extract

Inputs

Scrape

Inputs

Batch Create

Inputs

Browser Batch

Inputs

Browser Check

Inputs

Browser Clear Cookies

Inputs

Browser Click

Inputs

Browser Close

Inputs

Browser Drag

Inputs

Browser Evaluate

Inputs

Browser Fill

Inputs

Browser Focus

Inputs

Browser Go Back

Inputs

Browser Go Forward

Inputs

Browser Hover

Inputs

Browser Local Storage

Inputs

Browser Navigate

Inputs

Browser New Tab

Inputs

Browser Press Key

Inputs

Browser Reload