> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapegraphai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Get started with ScrapeGraphAI MCP Server - Connect LLMs to web scraping tools

## Overview

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 Cursor to perform AI-powered web scraping, research, and crawling directly through natural language interactions.

<Card title="⭐ Star us on GitHub" icon="star" href="https://github.com/ScrapeGraphAI/scrapegraph-mcp">
  If this server is helpful, a star goes a long way. Thanks!
</Card>

## What is MCP?

The Model Context Protocol (MCP) is a standardized way for AI assistants to access external tools and data sources. By using the ScrapeGraphAI MCP Server, your AI assistant gains access to powerful web scraping capabilities without needing to write code.

## Key Features

<CardGroup cols={2}>
  <Card title="17 Powerful Tools" icon="tools">
    Scrape, extract, search, crawl, generate schemas, monitor scheduled jobs (with activity polling), and manage your account
  </Card>

  <Card title="Remote & Local" icon="server">
    Use the hosted HTTP endpoint or run locally via Python
  </Card>

  <Card title="Universal Compatibility" icon="plug">
    Works with Cursor, Claude Desktop, and any MCP-compatible client
  </Card>

  <Card title="Production Ready" icon="shield-check">
    Robust error handling, timeouts, and reliability tested in production
  </Card>
</CardGroup>

## Available Tools

The MCP server exposes the following tools via API v2:

| Tool                   | Description                                                                                                             |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **scrape**             | Fetch page content in any format: markdown (default), html, screenshot, branding, links, images, summary (POST /scrape) |
| **extract**            | AI-powered structured extraction from a URL (POST /extract)                                                             |
| **search**             | Search the web and extract structured results (POST /search)                                                            |
| **crawl\_start**       | Start async multi-page crawl — markdown, html, links, images, summary, branding, or screenshot (POST /crawl)            |
| **crawl\_get\_status** | Poll crawl results (GET /crawl/:id)                                                                                     |
| **crawl\_stop**        | Stop a running crawl job (POST /crawl/:id/stop)                                                                         |
| **crawl\_resume**      | Resume a stopped crawl job (POST /crawl/:id/resume)                                                                     |
| **schema**             | Generate or augment a JSON Schema from a prompt (POST /schema)                                                          |
| **credits**            | Check your credit balance (GET /credits)                                                                                |
| **history**            | Browse request history with pagination (GET /history)                                                                   |
| **monitor\_create**    | Create a scheduled extraction job (POST /monitor)                                                                       |
| **monitor\_list**      | List all monitors (GET /monitor)                                                                                        |
| **monitor\_get**       | Get monitor details (GET /monitor/:id)                                                                                  |
| **monitor\_pause**     | Pause a running monitor (POST /monitor/:id/pause)                                                                       |
| **monitor\_resume**    | Resume a paused monitor (POST /monitor/:id/resume)                                                                      |
| **monitor\_delete**    | Delete a monitor (DELETE /monitor/:id)                                                                                  |
| **monitor\_activity**  | Poll tick history for a monitor with pagination (GET /monitor/:id/activity)                                             |

<Note>
  **Migrating from v2 (scrapegraph-mcp ≤ 2.x)?** Tools were renamed in v3.0.0 to match the v2 API canonical names: `smartscraper` → `extract`, `searchscraper` → `search`, `smartcrawler_initiate` → `crawl_start`, `smartcrawler_fetch_results` → `crawl_get_status`, `sgai_history` → `history`, `generate_schema` → `schema`. `markdownify` was removed — use `scrape` with `output_format="markdown"` instead. See the [v3.0.0 release notes](https://github.com/ScrapeGraphAI/scrapegraph-mcp/releases/tag/v3.0.0) for full details.
</Note>

## Quick Start

<Steps>
  <Step title="Get Your API Key">
    Create an account and copy your API key from the [ScrapeGraph Dashboard](https://scrapegraphai.com/dashboard)
  </Step>

  <Step title="Choose Your Client">
    Select your preferred AI assistant: <a href="/services/mcp-server/cursor">Cursor</a> or <a href="/services/mcp-server/claude">Claude Desktop</a>
  </Step>

  <Step title="Configure MCP">
    Follow the setup guide for your client to connect the MCP server
  </Step>

  <Step title="Start Scraping">
    Ask your AI assistant to scrape websites, extract data, or perform research
  </Step>
</Steps>

## Setup Guides

<CardGroup cols={2}>
  <Card title="Cursor Setup" icon="https://mintcdn.com/scrapegraphaiinc-9e950277/3eC85GCQlhpZd6A9/logo/APP_ICON_2D_DARK.png?fit=max&auto=format&n=3eC85GCQlhpZd6A9&q=85&s=60fd0bda96a73202515632f745e72893" href="/services/mcp-server/cursor" width="1024" height="1024" data-path="logo/APP_ICON_2D_DARK.png">
    Configure ScrapeGraph MCP in Cursor (remote-first)
  </Card>

  <Card title="Claude Desktop Setup" icon="https://mintcdn.com/scrapegraphaiinc-9e950277/PRteAQT1vZQ6-ik0/logo/claude-color.svg?fit=max&auto=format&n=PRteAQT1vZQ6-ik0&q=85&s=4a3fc52a53394c0f568a6171c3ad3a32" href="/services/mcp-server/claude" width="16" height="16" data-path="logo/claude-color.svg">
    Configure ScrapeGraph MCP in Claude Desktop (remote-first)
  </Card>
</CardGroup>

## Recommended: Remote HTTP Endpoint

The easiest way to get started is using our hosted MCP endpoint:

```
https://mcp.scrapegraphai.com/mcp
```

This requires no local installation and works seamlessly with both Cursor and Claude Desktop. See the setup guides above for configuration details.

## Local Installation

Prefer running locally? You can install the Python package and run it via stdio. This gives you more control and doesn't require internet connectivity for the MCP connection itself.

<Note>
  The remote endpoint is recommended for most users as it's simpler to set up and maintain.
</Note>

## Use Cases

* **Research & Analysis** - Extract data from multiple sources for research
* **Content Aggregation** - Collect and structure content from websites
* **Market Intelligence** - Monitor competitors and market trends
* **Lead Generation** - Extract contact information and company data
* **Data Collection** - Build datasets from web sources

## Next Steps

* Read the detailed setup guide for <a href="/services/mcp-server/cursor">Cursor</a>
* Read the detailed setup guide for <a href="/services/mcp-server/claude">Claude Desktop</a>
* Browse the [GitHub repo](https://github.com/ScrapeGraphAI/scrapegraph-mcp) for source, advanced configuration, and release notes

<Card title="Ready to Start?" icon="rocket" href="/services/mcp-server/cursor">
  Choose your client and start scraping with AI!
</Card>