# Scrapegraph Ai — MCP server on mcp.ai
> Connect your Scrapegraph Ai account and use 27 tools for web scraping straight from your AI agent. Connect with your own API key. ScrapeGraphAI is an AI-powered web scraping API that enables developers to extract structured data from any website using natural language prompts. Website https://scrapegraphai.com.

By: mcp.ai · official
Page: https://mcp.ai/scrapegraph_ai

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_scrapegraph_ai?ms=1787291340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/scrapegraph_ai/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/scrapegraph_ai/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/scrapegraph_ai/skill.md
Postman collection (v2.1): https://mcp.ai/scrapegraph_ai/postman.json

## Tools
- scrapegraph_ai_convert_webpage_to_markdown_v2(mock?: boolean, steps?: object[], stream?: boolean, headers?: object, stealth?: boolean, wait_ms?: integer, branding?: boolean, webhook_url?: string, website_url: string, country_code?: string, render_heavy_js?: boolean) — Tool to convert any webpage into clean, well-formatted Markdown with full parameter control. Use when you need advanced options like stealth mode, custom headers, or webhook notifications. Supports al
- scrapegraph_ai_generate_schema(user_prompt: string, existing_schema?: object) — Generate or modify a JSON schema based on a search query for structured data extraction. Use when you need a schema template for scraping specific data fields.
- scrapegraph_ai_get_agentic_scraper_history(page?: integer, page_size?: integer) — Retrieve paginated history of agentic scraper jobs. Use to view past scraping requests, their status, and results.
- scrapegraph_ai_get_crawler_history(page?: integer, page_size?: integer) — Retrieve the history of crawler jobs for your account. Returns paginated list of past crawler requests with their status, results, and metadata.
- scrapegraph_ai_get_credits() — Retrieve remaining and used credits for your ScrapeGraphAI account. Useful for checking credit availability before bulk scraping operations to avoid mid-run failures.
- scrapegraph_ai_get_endpoint_suggestions(prompt: string, website_url: string) — Tool to get AI-powered suggestions for creating scraping endpoints. Use when you need to identify what data can be extracted from a website and how to structure the scraping logic.
- scrapegraph_ai_get_live_session_url(url: string, timeout?: integer) — Tool to get a URL for a live browser session. Use when you need to interact with a webpage in real-time through a controlled browser environment.
- scrapegraph_ai_get_markdownify_history(page?: integer, page_size?: integer) — Tool to retrieve the history of markdownify webpage-to-Markdown conversion jobs. Use when you need to view past markdownify requests and their statuses.
- scrapegraph_ai_get_scrape_history(page?: integer, page_size?: integer) — Retrieve the history of scrape jobs from your ScrapeGraphAI account. Use this to check the status of past scrapes, view results, and track credit usage.
- scrapegraph_ai_get_searchscraper_history(page?: integer, page_size?: integer) — Get the history of searchscraper jobs with pagination support. Use this to retrieve past searchscraper requests, their status, and results.
- scrapegraph_ai_get_sitemap_history(page?: integer, page_size?: integer) — Tool to retrieve the history of sitemap extraction jobs. Use when you need to view past sitemap extraction requests, their status, and results.
- scrapegraph_ai_get_smartscraper_history(page?: integer, page_size?: integer) — Tool to retrieve the history of smartscraper jobs. Use when you need to view past scraping requests and their results.
- scrapegraph_ai_get_usage_timeline(days?: string) — Tool to retrieve usage timeline statistics for your ScrapeGraphAI account. Use when you need to visualize or analyze service usage patterns over time.
- scrapegraph_ai_get_webhook_logs(crawler_id: string) — Tool to retrieve webhook delivery logs for a crawler job. Use when you need to check the status and history of webhook notifications sent for a specific crawler execution.
- scrapegraph_ai_list_scheduled_jobs(page?: integer, is_active?: string, page_size?: integer, service_type?: string) — Retrieve a paginated list of all scheduled scraping jobs for your account. Use this action to view and manage your scheduled jobs, including their configuration, cron schedules, and active status. Sup
- scrapegraph_ai_markdownify_status(request_id: string) — Check the status and retrieve results of a Markdownify webpage-to-Markdown conversion job. Use this action to poll for the status of an async Markdownify request started via SCRAPEGRAPH_AI_MARKDOWNIFY
- scrapegraph_ai_save_endpoint(suggestions: object[]) — Tool to save custom scraping endpoint configurations to ScrapeGraphAI. Use when you need to create reusable scraping endpoints with specific parameters and extraction logic.
- scrapegraph_ai_search_scraper(mock?: boolean, query: string, language?: string, num_results?: integer, extraction_mode?: boolean) — Perform AI-powered web searches with structured, parsed results. Some sites block scrapers and return empty bodies; treat these as unrecoverable for that URL. JS-rendered pages may yield incomplete co
- scrapegraph_ai_search_scraper_status(request_id: string) — Check the status and results of an asynchronous SearchScraper job.
- scrapegraph_ai_smart_crawler_status(task_id: string) — Check the status and retrieve results of a SmartCrawler web crawling job. Use this action to poll for completion and get the extracted content from a previously started SmartCrawler job. Returns the j
- scrapegraph_ai_smart_scraper_start(mock?: boolean, wait?: boolean, steps?: object[], cookies?: object, headers?: object, stealth?: boolean, plain_text?: boolean, total_pages?: integer, user_prompt: string, website_url?: string, website_html?: string, output_schema?: object, render_heavy_js?: boolean, website_markdown?: string, number_of_scrolls?: integer) — Start AI-powered web scraping with natural language extraction prompts. When `wait` is false (default), returns a `request_id`; poll for results using SCRAPEGRAPH_AI_SMART_SCRAPER_STATUS. Check `error
- scrapegraph_ai_smart_scraper_status(request_id: string) — Check the status and retrieve results of a SmartScraper web scraping job. Use this action to poll for completion after starting a SmartScraper job with wait=false. The request_id is returned by the St
- scrapegraph_ai_start_smart_crawler(url: string, depth?: integer, rules?: object, prompt?: string, schema?: object, breadth?: integer, sitemap?: boolean, stealth?: boolean, max_pages?: integer, batch_size?: integer, webhook_url?: string, cache_website?: boolean, extraction_mode?: boolean, render_heavy_js?: boolean, same_domain_only?: boolean) — Tool to start a multi-page web crawl using SmartCrawler for AI-powered data extraction. Use when you need to extract structured data from multiple pages of a website. Returns immediately with a task_i
- scrapegraph_ai_submit_feedback(rating: integer, request_id: string, feedback_text?: string) — Submit feedback and ratings for completed ScrapeGraphAI requests.
- scrapegraph_ai_submit_product_feedback(name?: string, email?: string, issues?: string, rating?: integer, company?: string, disliked?: string, use_cases?: string[], liked_most?: string, setup_easy?: boolean, can_contact?: boolean, feedback_id: string, contact_method?: string, how_discovered?: string, recommend_score?: integer, usage_frequency?: string, requested_features?: string, improvement_suggestions?: string) — Submit product feedback for ScrapeGraphAI. Use to provide ratings, comments, suggestions, and other feedback about the product itself.
- scrapegraph_ai_toonify(data?: object) — Tool to convert JSON data to TOON (Token-Oriented Object Notation) format. Use when you need to reduce token usage for LLM processing while maintaining data structure.
- scrapegraph_ai_validate_api_key() — Validate your ScrapeGraphAI API key to ensure it is active and authorized. Use this action to check API key validity before making other API calls.

## Example prompts
- "What can I do in Scrapegraph Ai?"
- "Show me a summary of my Scrapegraph Ai account"

## Links
Docs: https://mcp.ai/docs/mcps/scrapegraph_ai
Website: https://mcp.ai/mcps/scrapegraph_ai