Skip to main content

​
Cursor Setup

Use the remote HTTP MCP endpoint (recommended): 
https://mcp.scrapegraphai.com/mcp
Add this to your Cursor MCP settings (~/.cursor/mcp.json): 
{
  "mcpServers": {
    "scrapegraph-mcp": {
      "url": "https://mcp.scrapegraphai.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

​
Local (stdio) alternative

If you prefer running locally: 
pip install scrapegraph-mcp
export SGAI_API_KEY=your-api-key
~/.cursor/mcp.json: 
{
  "mcpServers": {
    "scrapegraph-mcp-local": {
      "command": "python3",
      "args": ["-m", "scrapegraph_mcp.server"],
      "env": { "SGAI_API_KEY": "YOUR_API_KEY" }
    }
  }
}

​
Alternative: use the CLI directly

{
  "mcpServers": {
    "scrapegraph-mcp": {
      "command": "scrapegraph-mcp",
      "env": { "SGAI_API_KEY": "YOUR_API_KEY" }
    }
  }
}

​
Windows tip

If environment variables are tricky in Cursor on Windows: 
cmd /c "set SGAI_API_KEY=YOUR_API_KEY && python -m scrapegraph_mcp.server"
  • Ensure the CLI is on your PATH (it may be in ~/.local/bin or your venv).
  • You can use an absolute Python path if needed (e.g., from pyenv/venv).
  • Use python3 on macOS if python points to Python 2.

​
Optional: Smithery

npx -y @smithery/cli install @ScrapeGraphAI/scrapegraph-mcp --client claude
Use this only if you specifically want Smithery provisioning. Remote HTTP (above) is the simplest path.