MCP Directory

How to add Decodo MCP Server to Claude Desktop

Scrape websites, search engines, eCommerce, and social media for AI agents via Decodo's Web Scraping API. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

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

Claude Desktop config for Decodo MCP Server

npx -y @decodo/mcp-server
{
  "mcpServers": {
    "decodo-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.decodo.com/mcp",
        "--header",
        "Authorization: Basic <basic_auth_token>"
      ]
    }
  }
}

Claude Desktop connects to remote servers through the `mcp-remote` proxy (installed on first run via npx). Restart Claude Desktop after saving.

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Decodo MCP Server config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Decodo MCP Server's tools appear under the 🔌 tools menu.

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 Claude Desktop

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 + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_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 Claude Desktop?

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