Scrapegraph MCP Server

A production-ready [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server that provides seamless integration with the

Remote serverstreamable-httpPython

What is the Scrapegraph MCP Server?

A production-ready Model Context Protocol (MCP) server that provides seamless integration with the [ScrapeGraph

What the server does

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:

  • Scrape & extract — scrape (POST /scrape, multi-format), extract (POST /extract, URL + prompt)
  • Search — search (POST /search; num_results clamped 3–20)
  • Crawl — Async multi-page crawl with crawl_start / crawl_get_status / crawl_stop / crawl_resume
  • Schema — schema (POST /schema) — generate or augment a JSON Schema from a prompt
  • Monitors — Scheduled jobs via monitor_create, monitor_list, monitor_get, pause/resume/delete, monitor_activity (paginated tick history)
  • Account — credits, history

Credentials and setup notes

  • Python 3.13 or higher - pip or uv package manager - ScrapeGraph API key

Recorded tools

  • mypy — Static type checker
  • 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)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
scrapePOST /scrape (output_format: markdown, html, screenshot, branding, links, images, summary)
extractPOST /extract (requires website_url + user_prompt; optional output_schema)
searchPOST /search (num_results 1–20; supports country_search, time_range, output_schema)
crawl_startPOST /crawl — extraction_mode markdown / html / links / images / summary / branding / screenshot
crawl_get_statusGET /crawl/:id (poll until status: completed)
schemaPOST /schema (generate or augment a JSON Schema from a prompt)
creditsGET /credits
historyGET /history (paginated, service filter)
monitor_activityGET /monitor/:id/activity (paginated tick history: id, createdAt, status, changed, elapsedMs, diffs)
new_tool

How to install the Scrapegraph MCP Server

{
  "mcpServers": {
    "@ScrapeGraphAI-scrapegraph-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@ScrapeGraphAI/scrapegraph-mcp",
        "--config",
        "\"{\\\"scrapegraphApiKey\\\":\\\"YOUR-SGAI-API-KEY\\\"}\""
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.13 or higher - pip or uv package manager - ScrapeGraph API key

Example prompts to try

  • “Use Scrapegraph MCP to Markdownify.”
  • “Use Scrapegraph MCP to Extract.”
  • “Use Scrapegraph MCP to Ruff.”

Frequently asked questions

A production-ready [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server that provides seamless integration with the [ScrapeGraph Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.