# scrapegraphai

The ScrapeGraphAI MCP Server is a production-ready Model Context Protocol (MCP) server that connects Large Language Models (LLMs) to the ScrapeGraph AI API. It enables AI assistants like Claude and C…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add scrapegraphai-inc/sgai

# Browse available tools
npx -y smithery tool list scrapegraphai-inc/sgai

# Get full schema for a tool
npx -y smithery tool get scrapegraphai-inc/sgai extract

# Call a tool
npx -y smithery tool call scrapegraphai-inc/sgai extract '{}'
```

## Direct MCP Connection

Endpoint: `https://sgai--scrapegraphai-inc.run.tools`

**Required config:**
- `X-API-Key` (header) — Your ScrapeGraph API Key get it from https://scrapegraphai.com/dashboard/api-keys

## Tools (17)

- `extract` — Extract structured data from a webpage using AI (API v2 POST /extract).
- `search` — AI-powered web search with structured data extraction (API v2 POST /search).
- `crawl_start` — Start an asynchronous multi-page crawl (API v2 POST /crawl).
- `crawl_get_status` — Retrieve the results of an asynchronous SmartCrawler operation.
- `crawl_stop` — Stop a running crawl job (API v2 POST /crawl/:id/stop).
- `crawl_resume` — Resume a stopped crawl job (API v2 POST /crawl/:id/resume).
- `credits` — Return remaining API credits (API v2 GET /credits).
- `history` — List recent API requests (API v2 GET /history).
- `monitor_create` — Create a scheduled monitor job (API v2 POST /monitor).
- `schema` — Generate or augment a JSON Schema from a natural-language prompt
- `monitor_list` — List monitors (API v2 GET /monitor).
- `monitor_get` — Get one monitor by id (API v2 GET /monitor/:id).
- `monitor_pause` — Pause a monitor (API v2 POST /monitor/:id/pause).
- `monitor_resume` — Resume a paused monitor (API v2 POST /monitor/:id/resume).
- `monitor_delete` — Delete a monitor (API v2 DELETE /monitor/:id).
- `monitor_activity` — Poll per-run tick history for a monitor (API v2 GET /monitor/:id/activity).
- `scrape` — Fetch page content (API v2 POST /scrape).

```bash
# Get full input/output schema for a tool
npx -y smithery tool get scrapegraphai-inc/sgai <tool-name>
```

## Resources

- `scrapegraph://api/status` — Current status and capabilities of the ScapeGraph API server.
- `scrapegraph://examples/use-cases` — Common use cases and example implementations for ScapeGraph tools.
- `scrapegraph://parameters/reference` — Comprehensive parameter reference guide for all ScapeGraph MCP tools.
- `scrapegraph://tools/comparison` — Detailed comparison of ScapeGraph tools to help choose the right tool for each task.

## Prompts (2)

- `web_scraping_guide` — A comprehensive guide to using ScapeGraph's web scraping tools effectively.
- `quick_start_examples` — Quick start examples for common ScapeGraph use cases.