How to install PyScrappy in Windsurf

To install PyScrappy in Windsurf, paste the "pyscrappy" block into ~/.codeium/windsurf/mcp_config.json and refresh the MCP panel in Cascade.

Built from the published package · server updated 28 days ago

1
Open the MCP config
In Windsurf, open Settings, then Cascade, then MCP servers, and choose to view the raw config.

Add the server

Paste this into mcp_config.json:

{
  "mcpServers": {
    "pyscrappy": {
      "command": "uvx",
      "args": [
        "pyscrappy"
      ]
    }
  }
}

3
Refresh
Click refresh in the MCP panel. The server and its tools appear in Cascade.

Config file: ~/.codeium/windsurf/mcp_config.json

MCP servers run with your permissions. If PyScrappy needs an API key, add it under env in the config. Check its README.

Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.

Let your AI agent operate any website through a real, logged-in browser session.

Dark web OSINT over Tor: search onion engines, scrape pages, report with your own model.

Does PyScrappy work in Windsurf?

Yes. Windsurf supports local and remote mcp servers, and PyScrappy installs with the steps above.

PyScrappy does not show up in Windsurf. What now?

Restart Windsurf fully, check the JSON is valid, and make sure uv (for uvx) is installed. See common MCP errors and fixes.

Is PyScrappy safe?

It scores 82 of 100. Review the code before you install it, and only give it the access it needs. Grades and details.