# Decodo MCP MCP server

Enable your AI agents to scrape and parse web content dynamically, including geo-restricted sites

## At a glance

Decodo MCP is an MCP server in the Dev Tools & Git category. It runs locally over stdio via `npx -y @decodo/mcp-server`, and declares no required credentials. It exposes 33 tools, including scrape_as_markdown, screenshot and map. It scores A (85/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install Decodo MCP in Claude Code

1. Add the server

```bash
claude mcp add Decodo -- npx -y @decodo/mcp-server
```

2. Verify it's connected

```bash
claude mcp list
```

3. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

4. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. scrape_as_markdown, screenshot, map). It discovers them automatically.

### How to install Decodo MCP in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "Decodo": {
      "command": "npx",
      "args": [
        "-y",
        "@decodo/mcp-server"
      ]
    }
  }
}
```

3. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install Decodo MCP in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "Decodo": {
      "command": "npx",
      "args": [
        "-y",
        "@decodo/mcp-server"
      ]
    }
  }
}
```

2. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install Decodo MCP in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.Decodo]
command = "npx"
args = ["-y", "@decodo/mcp-server"]
```

2. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install Decodo MCP in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "Decodo": {
      "command": "npx",
      "args": [
        "-y",
        "@decodo/mcp-server"
      ]
    }
  }
}
```

2. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install Decodo MCP in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "Decodo": {
      "command": "npx",
      "args": [
        "-y",
        "@decodo/mcp-server"
      ]
    }
  }
}
```

### How to install Decodo MCP in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "Decodo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@decodo/mcp-server"
      ]
    }
  }
}
```

2. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `scrape_as_markdown` — Scrapes any target URL, expects a URL to be given via prompt. Returns results in Markdown.
- `screenshot` — Captures a screenshot of any webpage and returns it as a PNG image.
- `map` — Lists the URLs on a website without fetching their content. API key only.
- `crawl_start` — Starts crawling a website and returns the crawl id without waiting. API key only.
- `crawl_status` — Reports a crawl's progress: pages discovered, completed and failed. API key only.
- `crawl_results` — Returns crawled pages as Markdown, a few at a time with a cursor. API key only.
- `crawl_cancel` — Stops a running crawl; pages crawled so far stay readable. API key only.
- `search` — Searches the web and returns ranked results. API key only.
- `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.
- `amazon_product` — Scrapes Amazon Product page.
- `amazon_pricing` — Scrapes Amazon Product pricing information.
- `amazon_sellers` — Scrapes Amazon Seller information.
- `amazon_bestsellers` — Scrapes Amazon Bestsellers list.
- `walmart_search` — Scrapes Walmart Search for a given query, and returns parsed results.
- `walmart_product` — Scrapes Walmart Product page.
- `target_search` — Scrapes Target Search for a given query, and returns parsed results.
- `target_product` — Scrapes Target Product page.
- `tiktok_post` — Scrapes a TikTok post URL for structured data (e.g. engagement, caption, hashtags).
- `tiktok_shop_search` — Scrapes TikTok Shop Search for a given query, and returns parsed results.
- `tiktok_shop_product` — Scrapes TikTok Shop Product page.
- `tiktok_shop_url` — Scrapes TikTok Shop page by URL.
- `youtube_metadata` — Scrapes YouTube video metadata.
- `youtube_channel` — Scrapes YouTube channel videos.
- `youtube_subtitles` — Scrapes YouTube video subtitles.
- `youtube_search` — Search YouTube videos.
- `bing_search` — Scrapes Bing Search results.
- `chatgpt` — Sends a single prompt to ChatGPT and returns its answer (no conversation history).
- `perplexity` — Sends a single prompt to Perplexity and returns its answer (no conversation history).

Source repository: https://github.com/Decodo/mcp-server

---

Source: https://mcp-skills-hub.vercel.app/mcps/io-github-decodo-mcp-server · MCP Skills Hub · data as of 2026-10-28T12:31:05Z