# MrScraper — MCP server on mcp.ai
> Connect your MrScraper account and use 11 tools for web scraping straight from your AI agent. Connect with your own API key. MrScraper provides web scraping APIs for structured extraction, search results, marketplace data, travel data, and web unblocking.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_mrscraper?ms=1787293560000
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/mrscraper/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/mrscraper/<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/mrscraper/skill.md
Postman collection (v2.1): https://mcp.ai/mrscraper/postman.json

## Tools
- mrscraper_bulk_rerun_ai_scraper(urls: string[], scraper_id: string) — Run an existing General AI scraper configuration against multiple URLs in one request. Returns the accepted bulk result ID for Get Scrape Result.
- mrscraper_bulk_rerun_manual_scraper(urls: string[], scraper_id: string) — Run an existing saved manual scraper workflow against multiple URLs in one request. Returns the accepted bulk result ID for Get Scrape Result.
- mrscraper_create_ai_scraper(url: string, agent?: string, limit?: integer, message?: string, max_depth?: integer, max_pages?: integer, proxy_country?: string, exclude_patterns?: string[], include_patterns?: string[]) — Create and run a general, listing, or map AI scraper against a website.
- mrscraper_get_account_usage() — Return the connected MrScraper account's plan, token usage, concurrency allowance, and rate limits without exposing user identity or token details.
- mrscraper_get_analytic_statuses(action?: string, domain: string, end_date: string, start_date: string, api_token_name?: string) — Return aggregate scrape counts, success rate, request rate, latency, and status totals for a domain and action over a time range.
- mrscraper_get_analytic_timeline(action?: string, domain: string, end_date: string, start_date: string, api_token_name?: string) — Return time-series scrape activity and success metrics for a domain and action over a time range.
- mrscraper_get_result(result_id: string) — Retrieve the current status and output for one accessible scrape result by ID.
- mrscraper_heal_manual_scraper(scraper_id: string) — Ask MrScraper to repair an existing manual scraper workflow that no longer matches its target site.
- mrscraper_list_results(end_at?: string, search?: string, start_at?: string, page_size?: integer, sort_field?: string, sort_order?: string, next_cursor?: string, date_range_column?: string) — List scrape results for the connected account with filtering, sorting, and agent-controlled pagination.
- mrscraper_rerun_ai_scraper(url: string, limit?: integer, max_depth?: integer, max_pages?: integer, scraper_id: string, exclude_patterns?: string[], include_patterns?: string[]) — Run an existing AI scraper configuration against a new URL, with optional map crawl controls.
- mrscraper_rerun_manual_scraper(url: string, scraper_id: string) — Run an existing saved manual scraper workflow against a new URL.

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

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