A production-ready [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server that provides seamless integration with the
Connect Scrapegraph MCP to Claude, Cursor or any other MCP client and it stops being a tab you switch to. A production-ready Model Context Protocol (MCP) server that provides seamless integration with the [ScrapeGraph. The scrapegraph mcp mcp server is what makes that connection.
This MCP server targets ScrapeGraph API v2 (https://v2-api.scrapegraphai.com/api), aligned 1:1 with scrapegraph-py PR #84. Auth uses the SGAI-APIKEY header. Environment variables mirror the Python SDK:
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
Markdownify — "Convert the ScrapeGraph documentation page to markdown"Extract — "Extract all product names, prices, and ratings from this e-commerce page"Ruff — Fast Python linter and formattermypy — Static type checkerHatchling — Modern build backendAuthentication — API key-basedscrape — POST /scrape (output_format: markdown, html, screenshot, branding, links, images, summary)extract — POST /extract (requires website_url + user_prompt; optional output_schema)search — POST /search (num_results 1–20; supports country_search, time_range, output_schema)crawl_start — POST /crawl — extraction_mode markdown / html / links / images / summary / branding / screenshotcrawl_get_status — GET /crawl/:id (poll until status: completed)schema — POST /schema (generate or augment a JSON Schema from a prompt)Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.
Configuration is passed through the environment: SGAI_API_KEY, SGAI_API_URL, SCRAPEGRAPH_API_BASE_URL, YOUR_API_KEY, SCRAPEGRAPH_MCP_PATH, SERVER_SCRIPT_PATH, BASE_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Among the search and retrieval options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Scrapegraph MCP's toolset — Markdownify, Extract, Ruff and 11 more — is a fair guide to whether it matches your workflow. It is maintained by ScrapeGraphAI; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| Markdownify | "Convert the ScrapeGraph documentation page to markdown" |
| Extract | "Extract all product names, prices, and ratings from this e-commerce page" |
| Ruff | Fast Python linter and formatter |
| mypy | Static type checker |
| Hatchling | Modern build backend |
| Authentication | API key-based |
| scrape | POST /scrape (output_format: markdown, html, screenshot, branding, links, images, summary) |
| extract | POST /extract (requires website_url + user_prompt; optional output_schema) |
| search | POST /search (num_results 1–20; supports country_search, time_range, output_schema) |
| crawl_start | POST /crawl — extraction_mode markdown / html / links / images / summary / branding / screenshot |
| crawl_get_status | GET /crawl/:id (poll until status: completed) |
| schema | POST /schema (generate or augment a JSON Schema from a prompt) |
| credits | GET /credits |
| history | GET /history (paginated, service filter) |
{
"mcpServers": {
"scrapegraph": {
"command": "npx",
"args": ["-y", "@smithery/cli"],
"env": {
"SGAI_API_KEY": "your-value",
"SGAI_API_URL": "your-value",
"SCRAPEGRAPH_API_BASE_URL": "your-value",
"YOUR_API_KEY": "your-value",
"SCRAPEGRAPH_MCP_PATH": "your-value",
"SERVER_SCRIPT_PATH": "your-value",
"BASE_URL": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| SGAI_API_KEY | Credential the server authenticates with. | Yes |
| SGAI_API_URL | Endpoint or connection string the server talks to. | Yes |
| SCRAPEGRAPH_API_BASE_URL | Endpoint or connection string the server talks to. | Yes |
| YOUR_API_KEY | Credential the server authenticates with. | Yes |
| SCRAPEGRAPH_MCP_PATH | Filesystem location the server is allowed to use. | Optional |
| SERVER_SCRIPT_PATH | Filesystem location the server is allowed to use. | Optional |
| BASE_URL | Endpoint or connection string the server talks to. | Yes |
The simplest web tool that matters — fetch any URL and get model-ready markdown back.
Industrial-strength web extraction — render, scrape, crawl and search entire sites into clean markdown.
Puppeteer-powered browser control that drives pages from the accessibility tree instead of pixels.
Search built for AI, not humans — semantic web search that returns model-ready content, plus code context.
Answers, not links — delegate questions to Perplexity's search-grounded models and get cited responses back.
Put 6,000+ pre-built scrapers at your assistant's fingertips through one MCP endpoint.