How to add Decodo MCP Server to Cursor

Scrape websites, search engines, eCommerce, and social media for AI agents via Decodo's Web Scraping API. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 30★ · http · apikey

Cursor config for Decodo MCP Server

npx -y @decodo/mcp-server

{
  "mcpServers": {
    "decodo-mcp-server": {
      "url": "https://mcp.decodo.com/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Basic <basic_auth_token>"
      }
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

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

Before you start

A Decodo account with a Web Scraping API Basic authentication token (free tier: up to 2,000 requests, no credit card required)
An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
Node.js 18.0+ (required for the local/npx stdio setup)

What Decodo MCP Server can do in Cursor

scrape_as_markdown

Scrapes any target URL given via prompt and returns the results in Markdown.

screenshot

Captures a screenshot of any webpage and returns it as a PNG image.

google_search

Scrapes Google Search for a given query and returns parsed results.

google_ads

Scrapes Google Ads search results.

google_lens

Scrapes Google Lens image search results.

google_ai_mode

Scrapes Google AI Mode (Search with AI) results.

google_travel_hotels

Scrapes Google Travel Hotels search results.

amazon_search

Scrapes Amazon Search for a given query and returns parsed results.

Security

Authentication uses a Decodo Web Scraping API Basic auth token. For the hosted server pass it as an 'Authorization: Basic <basic_auth_token>' header; for the local stdio server pass it via the SCRAPER_API_TOKEN environment variable. Keep this token secret — do not commit it to source control.

Decodo MCP Server + Cursor FAQ

Where is the Cursor config file?

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

Is Decodo MCP Server safe to use with Cursor?

Do I need to build my own scraping infrastructure?

No. Decodo handles proxy rotation, CAPTCHA solving, anti-bot systems, and JavaScript rendering server-side, giving you a single integration point for reliable web data.

How do I authenticate?

Use a Web Scraping API Basic authentication token from the Decodo dashboard. For the hosted server, pass it as an 'Authorization: Basic <basic_auth_token>' header; for the local stdio server, set it via the SCRAPER_API_TOKEN environment variable.

Can I enable only some of the tools?

Yes. Tools are grouped into toolsets (web, search, ecommerce, social_media, ai). Pass a comma-separated list via the TOOLSETS env var (local) or the ?toolsets= query parameter (hosted URL). When none are specified, all tools are registered.

View repo Full Decodo MCP Server page