MCP Directory

How to add Decodo MCP Server to Windsurf

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

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

Windsurf config for Decodo MCP Server

npx -y @decodo/mcp-server
{
  "mcpServers": {
    "decodo-mcp-server": {
      "serverUrl": "https://mcp.decodo.com/mcp",
      "headers": {
        "Authorization": "Basic <basic_auth_token>"
      }
    }
  }
}

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

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Decodo MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Decodo MCP Server's tools become available to Cascade.

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 Windsurf

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Decodo MCP Server config there under the "mcpServers" key and restart the client.

Is Decodo MCP Server safe to use with Windsurf?

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.

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