MCP Directory

How to add Bright Data MCP to Cursor

All-in-one web access MCP — Web Unlocker, SERP, Scraper API, and a cloud Scraping Browser. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 15, 2026 · 5.0k★ · stdio · apikey · official

Cursor config for Bright Data MCP

npx -y @brightdata/mcp
{
  "mcpServers": {
    "bright-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@brightdata/mcp"
      ],
      "env": {
        "API_TOKEN": "<your-brightdata-api-token>"
      }
    }
  }
}

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Bright Data MCP config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Bright Data MCP's tools to confirm it's connected.

Before you start

  • Node.js installed (for local npx execution); not needed if you use the hosted remote server
  • A Bright Data API token — sign up at https://brightdata.com and create the token in your account (free tier available, no credit card required)
  • Set the token via the API_TOKEN environment variable (local) or the ?token= query param (hosted)

What Bright Data MCP can do in Cursor

search_engine

Run an AI-optimized web search (Google/Bing/etc.) and get ranked results.

search_engine_batch

Batch multiple search-engine queries in one call.

scrape_as_markdown

Fetch a URL through Web Unlocker and return clean markdown.

scrape_batch

Scrape multiple URLs in a single batched request.

discover

AI-ranked search with intent scoring to surface the most relevant pages.

extract

AI-assisted extraction of fields from a page (Pro/advanced).

web_data_amazon_product

Structured product data from Amazon (one of 50+ web_data_* dataset tools).

web_data_linkedin_posts

Structured LinkedIn post data (social dataset).

Security

The API_TOKEN bills against your Bright Data account and PRO_MODE exposes 60+ powerful scraping tools, so keep the token in env and only enable PRO_MODE when needed. Content is fetched through Bright Data's proxy network, which sees the target URLs and returned data.

Bright Data MCP + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Bright Data MCP config there under the "mcpServers" key and restart the client.

Is Bright Data MCP safe to use with Cursor?

The API_TOKEN bills against your Bright Data account and PRO_MODE exposes 60+ powerful scraping tools, so keep the token in env and only enable PRO_MODE when needed. Content is fetched through Bright Data's proxy network, which sees the target URLs and returned data.

Is there a free tier?

Yes — 5,000 credits/month with no credit card required, and it auto-renews. Base tools cost 1 credit per request; web_data_* tools cost 1 credit per record returned. Unused credits don't roll over.

Do I have to install anything?

No. You can use the hosted remote server at https://mcp.brightdata.com/mcp?token=... with no install, or run it locally via npx @brightdata/mcp.

How do I enable the full set of tools?

Set PRO_MODE=true to expose all 60+ tools. For a narrower set, use the GROUPS env var (e.g. ecommerce, social, browser) or list individual tools via the TOOLS env var.

View repo Full Bright Data MCP page