MrScraper connects Grok Build to a hosted MCP server for retrieving public web pages as HTML, Markdown, or screenshots, web search, and account usage. The plugin also includes three focused skills that help Grok choose the right workflow and preserve raw page content.
- The hosted Streamable HTTP endpoint at
https://mcp.mrscraper.com/mcp. - OAuth 2.1 authentication through Grok Build's MCP client; no credential is stored in this repository.
- A retrieve-first workflow that keeps raw page responses available for analysis, verification, and follow-up transformations.
- A current version of Grok Build.
- A MrScraper account.
- Permission to access and process the target content.
From the xAI Official marketplace:
grok plugin marketplace add xai-org/plugin-marketplace
grok plugin install mrscraper --trustInside a Grok Build session, you can instead type /marketplace, search for
mrscraper, and press i.
If mrscraper is not listed in the xAI Official marketplace yet, install it
from this repository's own marketplace, which xAI does not review:
grok plugin marketplace add mrscraper-com/mrscraper-grok-plugin
grok plugin install mrscraper@mrscraper-grok-plugin --trust--trust confirms the installation. Grok Build does not load the skills or
start the MCP server of a plugin you have not trusted.
Start grok, open /mcps, select mrscraper, and press i. Grok Build opens
the MrScraper consent page in your browser; sign in and approve access. Grok
Build registers its own OAuth client and requests the scrape:read,
scrape:write, and account:read scopes advertised by the server, plus
offline_access so it can refresh the token. Never paste OAuth tokens or API
keys into chat.
Until you sign in, grok mcp doctor mrscraper reports that the handshake
failed with Auth required. Run it again after sign-in to confirm the
connection.
Fetch https://www.scrapethissite.com/pages/simple/ and summarize the page.
The connection exposes these MCP tools, shown in Grok Build as
mrscraper__<tool>:
| Tool | Purpose |
|---|---|
scraperAPI |
Retrieve a known page as HTML, Markdown, a screenshot, or a combination. |
webSearch |
Discover public pages through web search. |
status |
Inspect subscription status, token usage, and remaining tokens. |
When a public URL is already known, the skills direct Grok to retrieve it with
scraperAPI first and treat the raw response as the source of truth. Grok can
read, summarize, compare, or derive structured output locally without losing
details.
For roughly 100 known pages that share a layout, Grok can retrieve pages concurrently, retain every raw response, and apply one reusable local extractor.
The plugin sends MCP tool inputs, including target URLs and search queries, to MrScraper's hosted service. Page responses and tool results are then available to Grok for the requested task. Use it only with public or otherwise authorized content, and follow the target site's requirements.
Network endpoints and credentials:
https://mcp.mrscraper.com/mcp: the hosted MCP server, reached over HTTPS. Tool inputs are sent here.https://api.app.mrscraper.com: the OAuth 2.1 authorization server (authorization, token, and dynamic client registration endpoints), advertised in the server's protected resource metadata athttps://mcp.mrscraper.com/.well-known/oauth-protected-resource/mcp.https://app.mrscraper.com: the MrScraper sign-in and consent pages opened in your browser.- Credentials: a MrScraper account and the OAuth grant Grok Build stores in
~/.grok/mcp_credentials.json. The plugin reads no environment variables or files and ships no hooks, scripts, or executables.
Review MrScraper's MCP documentation, Privacy Policy, and Acceptable Use Policy before use.
grok plugin marketplace update
grok plugin update mrscraper
grok plugin uninstall mrscraperIf you installed the CLI-oriented MrScraper skills with
mrscraper init --agent grok, Grok Build keeps both skill sets and shows
qualified names such as /user:mrscraper-fetch and
/mrscraper:mrscraper-fetch. Keep only the set that matches how you connect:
this plugin for MCP, or the CLI skills for the mrscraper command.
- Product help: MrScraper MCP documentation
- Bugs and feature requests: GitHub Issues
- Account help: support@mrscraper.com
- Security reports: see SECURITY.md
The repository is both an installable Grok Build marketplace and the source of
the mrscraper plugin:
.grok-plugin/marketplace.json
plugins/mrscraper/
├── .grok-plugin/plugin.json
├── .mcp.json
└── skills/
Validate the plugin and its marketplace before a release:
grok plugin validate plugins/mrscraper
grok plugin marketplace add .
grok plugin install mrscraper@mrscraper-grok-plugin --trust
grok inspectThe plugin uses semantic versions from its plugin manifest. Bump that version for every release and record user-visible changes in CHANGELOG.md. Use PUBLISHING.md for the release and xAI marketplace checklist.