MrScraper

npx add-mcp 'https://mcp.mrscraper.com/mcp'

MrScraper MCP Server

The official Model Context Protocol (MCP) server for MrScraper: give your AI assistant live web data. Read any public page as Markdown, HTML, or a screenshot, search the web, and check your plan usage, through a hosted endpoint with browser sign-in or a local server you run yourself.

Documentation · Tool reference · Security · Support

---

MrScraper MCP connects AI assistants and agents to MrScraper's web data service. Once connected, your assistant can retrieve any public web page, discover pages through web search, and check how many tokens your plan has left, without you copying pages into the chat.

With MrScraper MCP, you can:

• Read a page. Fetch a public page as Markdown, HTML, or a screenshot, or all three at once.
• Read pages that need a browser. Browser rendering starts automatically when a page needs it; you can also wait for an element to appear and load the page from a chosen country.
• Search the web. Get parsed results (rank, title, link, snippet) for a query, then fetch the pages you need.
• Research and compare. Combine search and page reads to compare pricing pages, product pages, or documentation across sites, with the source pages kept for reference.
• Check your usage. Ask how many tokens your plan has left.

One-click setup

Pick your AI client. Each client signs you in to MrScraper in your browser the first time you use a tool, so there is no API key to paste.

Add to Cursor One-click install.	Add to VS Code One-click install.	Get the JetBrains plugin For JetBrains AI agents.
Add to Claude As a custom connector.	Add to Claude Code One command.	Add to Codex One command.

Let your agent do the setup

Most AI coding agents can configure the server themselves. Paste this prompt into your agent:

Connect MrScraper MCP to this agent. Detect the current MCP client and configure a Streamable HTTP server named mrscraper at https://mcp.mrscraper.com/mcp with no credential. The server uses OAuth 2.1, so the client will open a browser to sign in. If the client cannot do OAuth, fall back to a MrScraper API key from https://app.mrscraper.com/api-tokens stored through the client's environment-variable or secret-storage mechanism and sent as Authorization: Bearer <key>. Reload the MCP client when required, then list the tools and confirm that scraperAPI, webSearch, and status are the only available tools.

Tools

Tool	What it does
scraperAPI	Retrieves a known URL as HTML, Markdown, a screenshot, or a combination. Options include browser rendering, waiting for a CSS selector, country, timeout, and retry limits.
webSearch	Runs a web search from query text or a complete search results URL and returns parsed JSON or the result page HTML. Options include region, language, and page.
status	Returns the account's plan, token limit, token usage, remaining tokens, and rate limit.

The web tools are read-only. Hosts that support MCP Apps also show a search results widget and an account usage meter.

Connect manually

Endpoint (Streamable HTTP):

https://mcp.mrscraper.com/mcp

Add the URL to your MCP client with no credential. The client opens your browser, you sign in to MrScraper and approve access, and the client stores the tokens. Use the URL exactly as shown, including /mcp.

Claude Code:

claude mcp add --transport http --scope user mrscraper https://mcp.mrscraper.com/mcp

Codex:

codex mcp add mrscraper --url https://mcp.mrscraper.com/mcp

Clients configured by file:

{
  "mcpServers": {
    "mrscraper": {
      "url": "https://mcp.mrscraper.com/mcp"
    }
  }
}

Permissions you approve

Scope	Allows
scrape:read	webSearch
scrape:write	scraperAPI
account:read	status

You can disconnect a client at any time under Connected applications in your MrScraper account.

Use an API key instead

Clients without OAuth can send a MrScraper API key, created at app.mrscraper.com/api-tokens, as a bearer token:

{
  "mcpServers": {
    "mrscraper": {
      "url": "https://mcp.mrscraper.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MRSCRAPER_API_KEY"
      }
    }
  }
}

An API key carries your full account access. Keep it in your client's secret or environment-variable storage, never in a shared project file.

Run it locally

The same server is open source and published on npm as @mrscraper/mcp. Local setups use a MrScraper API key instead of browser sign-in.

# stdio, for clients that start a local process; reads the key from MRSCRAPER_API_KEY
MRSCRAPER_API_KEY=YOUR_MRSCRAPER_API_KEY npx -y @mrscraper/mcp@latest

# local Streamable HTTP service; clients send the key as a bearer token
TRANSPORT=http npx -y @mrscraper/mcp@latest

Plugins

MrScraper is also packaged as a plugin with the MCP server and skills for Claude Code and JetBrains IDEs.

Data and usage

• A MrScraper account is required. Each call uses tokens from your plan; see mrscraper.com/pricing.
• MrScraper receives the URLs and tool inputs you send, including search queries, and returns the results to your client.
• Retrieve only content you are allowed to access, and follow each site's terms and MrScraper's Acceptable Use Policy.

Links

• Documentation: https://docs.mrscraper.com/docs/getting-started/mcp-server
• Source: https://github.com/mrscraper-com/mrscraper-mcp
• Official MCP Registry: io.github.mrscraper-com/mrscraper-mcp
• Privacy policy: https://mrscraper.com/privacy-policy
• Terms of use: https://mrscraper.com/terms-of-use
• Support: support@mrscraper.com