> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zenrows.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ZenRows MCP Integration for Cursor

> Add the ZenRows MCP server to Cursor so your AI coding assistant can scrape websites and extract structured data inside the editor.

## Before you start

You need:

<Columns cols={2}>
  <Card icon="user" href="https://app.zenrows.com/register" title="ZenRows Account">A **ZenRows account**</Card>
  <Card icon="key" href="https://app.zenrows.com/dashboard" title="ZenRows API Key">Your **ZenRows API key**</Card>
</Columns>

<Card icon="code" href="https://nodejs.org/en/download/" title="Node.js">Latest version of **Node.js** installed on your machine</Card>
<Card icon="robot" href="https://www.cursor.com" title="Cursor">**Cursor** installed</Card>

## Setup

<Steps>
  <Step title="Step 1: Open the configuration file">
    Open the MCP configuration file for your setup:

    * **Global (all projects):** `~/.cursor/mcp.json`
    * **Project-specific:** `.cursor/mcp.json` in your project root

    If the file does not exist yet, create it.
  </Step>

  <Step title="Step 2: Add the ZenRows MCP server">
    Paste the following into the configuration file, replacing `YOUR_ZENROWS_API_KEY` with your actual API key:

    ```json theme={null}
    {
    "mcpServers": {
        "zenrows": {
            "command": "npx",
            "args": ["-y", "@zenrows/mcp"],
            "env": {
                "ZENROWS_API_KEY": "YOUR_ZENROWS_API_KEY"
                }
            }
        }
    }
    ```
  </Step>

  <Step title="Step 3: Restart Cursor">
    Save the file and restart Cursor to load the new configuration.
  </Step>
</Steps>

## Start scraping

Ask Cursor's AI assistant to scrape a webpage or automate a browser workflow in plain English:

```
Get the product names and prices from https://www.scrapingcourse.com/ecommerce/.
```

```
Scrape https://www.scrapingcourse.com/antibot-bypass using Premium Proxies.
```

```
Fetch https://www.scrapingcourse.com/javascript-rendering/ with JavaScript rendering enabled and return the page as Markdown.
```

```
Open https://scrapingcourse.com/login in a browser, fill in the credentials, click submit, then extract the account details.
```

## Troubleshooting

**The `scrape` tool is not available**

Confirm the configuration file is saved in the correct location and contains valid JSON. You can validate the JSON syntax at [jsonlint.com](https://jsonlint.com). Then restart Cursor.

**Page content is missing or incomplete**

The page likely loads content dynamically. Ask the assistant to enable JavaScript rendering:

```
Scrape https://www.scrapingcourse.com/javascript-rendering/ with `js_render: true`.
```

**Requests return a 403 or bot detection page**

Ask the assistant to use Premium Proxies:

```
Scrape https://www.scrapingcourse.com/antibot-bypass using `premium_proxy: true`.
```

For more troubleshooting options, see the [ZenRows MCP overview](https://docs.zenrows.com/integrations/mcp/mcp-overview#troubleshooting).
