Ad space · Your tool here
PluginStack
MCP Servers · by Karim Shoair (D4Vinci)

Scrapling MCP Server

Scrapling MCP Server official site ↗

Last checked against the official docs:

What it does

The MCP server built into Scrapling, an open-source Python web scraping library. It gives an AI agent one-shot tools that fetch a single URL over HTTP or in a browser, and session tools that keep a browser tab open for clicks, screenshots, CSS-selector extraction and network-request history. Browser tools block known ad and tracker domains, and the server strips hidden page content (hidden elements, zero-width characters, HTML comments) that could carry prompt-injection text. Scrapling also has stealth features meant to get past anti-bot checks; its README says to follow scraping and privacy laws and to respect each site's terms of service and robots.txt. BSD-3-Clause licensed.

Who it's for

People who want Claude, Cursor or another MCP client to read and extract data from web pages, including JavaScript-heavy ones, running on their own machine instead of a paid scraping API.

How to set it up

  1. Needs Python 3.10 or newer. Install Scrapling with its AI extras, then install the browsers and system dependencies the browser tools use (plain HTTP requests don't need this step):

    bash
    pip install "scrapling[ai]"
    scrapling install
  2. Add it to Claude Desktop, Cursor or another client that uses an mcpServers file. scrapling-mcp was added in v0.4.13; on older versions use "command": "scrapling" with "args": ["mcp"]:

    json
    {
      "mcpServers": {
        "ScraplingServer": {
          "command": "scrapling-mcp"
        }
      }
    }
  3. If you installed it in a virtual environment, the client may not find the command. Use the full path instead: find it with which scrapling-mcp (macOS/Linux) or where scrapling-mcp (Windows). In Claude Code:

    bash
    claude mcp add ScraplingServer "/full/path/to/scrapling-mcp"
  4. Or run it from the official Docker image:

    bash
    docker run -i --rm pyd4vinci/scrapling mcp
  5. Quit and restart the client after adding it. Over HTTP (scrapling-mcp --http), the server requires an auth token unless you explicitly pass --no-auth, because anyone who can reach the port could call every tool, including fetching any URL from your machine. Set it with the SCRAPLING_MCP_AUTH_TOKEN environment variable rather than on the command line.

Check the official Scrapling MCP Server docs for the latest steps.

Install Scrapling MCP Server in your client

Runs on your computer. Needs: Python 3.10 or later, with pip install "scrapling[ai]" and scrapling install. Sign-in or keys: None.

One-click install

These buttons open the app on your computer (it needs to be installed already). The app asks you to confirm before it adds the server: review the command or URL it shows and check it matches the snippet below before you approve.

Claude Code

Run in a terminal

bash
claude mcp add --transport stdio ScraplingServer -- scrapling-mcp

Everything after -- is the server command. Run /mcp inside Claude Code to check it connected.

Claude Desktop

Settings → Developer → Edit Config (claude_desktop_config.json)

json
{
  "mcpServers": {
    "ScraplingServer": {
      "command": "scrapling-mcp",
      "args": []
    }
  }
}

Fully quit and reopen Claude Desktop after saving.

Cursor

.cursor/mcp.json in a project, or ~/.cursor/mcp.json for all projects

json
{
  "mcpServers": {
    "ScraplingServer": {
      "command": "scrapling-mcp",
      "args": []
    }
  }
}
VS Code

.vscode/mcp.json (note the top-level "servers" key)

json
{
  "servers": {
    "ScraplingServer": {
      "type": "stdio",
      "command": "scrapling-mcp",
      "args": []
    }
  }
}
Codex

Run in a terminal, or edit ~/.codex/config.toml

CLI

bash
codex mcp add ScraplingServer -- scrapling-mcp

Or in ~/.codex/config.toml

toml
[mcp_servers.ScraplingServer]
command = "scrapling-mcp"
args = []
  • If the client can't find scrapling-mcp, replace it with the full path from which scrapling-mcp (or where scrapling-mcp on Windows).
  • If the server shows as failed or disconnected, see fixing MCP error -32000.
  • Compare every server's runtime and sign-in needs in the MCP server requirements table.

Checked against the official docs. Snippets use placeholders; keep real keys out of files you commit. Windsurf is not listed because we have not verified its format.

Set it up / Fixes

Step-by-step guides for getting Scrapling MCP Server running and fixing common errors.

Example prompts

prompt
Use make_request to fetch https://example.com/blog and list every post title with its date.
prompt
Use browser_fetch_once on this product page and extract the name, price and stock status with CSS selectors.
prompt
Open the page in a browser session, click Load more twice, then show me the network requests that returned JSON.

Made Scrapling MCP Server? Add the badge

If you like, show that Scrapling MCP Server is listed and hand-checked here. It's optional: listings are free and we never ask for a link back.

Hand-checked on PluginStack
Get the Markdown or HTML

Markdown (for a GitHub README)

markdown
[![Hand-checked on PluginStack](https://www.pluginstackai.com/badge/hand-checked.svg)](https://www.pluginstackai.com/plugins/scrapling-mcp/)

HTML (for a website)

html
<a href="https://www.pluginstackai.com/plugins/scrapling-mcp/"><img src="https://www.pluginstackai.com/badge/hand-checked.svg" alt="Hand-checked on PluginStack" width="226" height="28"></a>

About the badge

Free: MCP Starter Checklist

After you set this tool up, use the one-page checklist so your next MCP server doesn't fail on first connect.

Markdown download + occasional PluginStack updates. No spam. Privacy policy.

See all MCP Servers on PluginStack