Skip to main content
The hosted MCP server gives your agent Stophy tools to search, scrape, map, parse, crawl, extract, run agent tasks, drive browsers and watch pages. Add its URL to your client’s MCP settings. It is not a web page. To have your agent do this, paste: Use curl to read https://docs.stophy.dev/agent-quickstart.md and connect the Stophy MCP server to this agent.

Choose how to connect

Clients that support MCP OAuth start the sign-in on their own. Signing out of stophy.dev disconnects the app. Clients and registries can read the server’s URL and sign-in from mcp.json.

Add it to your client

These commands use browser sign-in. For no key or a key, use the api.stophy.dev URL.
Restart Cursor after you edit its file. In Windsurf, open the file with Open MCP config file in the Cascade MCP menu. If you see two stophy servers in Claude Code, run claude mcp remove stophy and add the one you want. Claude on the web, desktop or mobile: open Customize > Connectors, click + Add, then Add custom connector, name it Stophy, paste https://mcp.stophy.dev/mcp and continue. Claude opens stophy.dev to approve. Turn Stophy on per chat under + > Connectors. The Free plan allows one custom connector. Grok: open grok.com/connectors, click New Connector, then Custom, paste the URL and sign in.

Use an API key

Keep the key in STOPHY_API_KEY, never in a file you commit. Get credentials has every way to get one. The server refuses a wrong key. An agent with no key can call stophy_signup, which returns a link for you to approve and a code, then the key when called again with the code. See Sign up from an agent.

Tools

With sign-in or a key, the server lists a tool for each product. Without a key it lists only stophy_search, stophy_scrape, stophy_map, stophy_parse and stophy_signup. A call costs what it does over HTTP, and costUsd in a result is what it cost. See Pricing. Ask “What are people saying about Bun on Reddit?” and the agent calls stophy_scrape with a Reddit search URL and "formats": [{ "type": "json", "parser": "reddit-search" }]. See Pre-built parsers. A tool’s description names the inputs its schema leaves out, such as profile on stophy_scrape. They work as over HTTP. Page Markdown and HTML come back as their own text blocks after the JSON, which keeps [text block 2] in their place. Over MCP, stophy_scrape keeps link text and drops link addresses: send "linkStyle": "inline" for [text](address), or add links to formats.

Drive a browser

stophy_browser_upload puts a file in an open browser. stophy_browser_task gives a goal to an agent that clicks through a public site and answers, as in Browser tasks, and stophy_browser_task_cancel stops it. steps is up to 50 actions that run in order and stop at the first failure. The actions are open, back, reload, snapshot, click, dblclick, hover, check, uncheck, fill, type, press, select, scroll, drag, find, wait, get, is, read, screenshot, pdf, tab, dialog, upload, network and console. A step names an element by its ref from the latest page, and find picks one by role and name. Steps that can change the page answer with the page as its own text block. read, screenshot, pdf, get, is, network and console only look, so a call of only those leaves the page out; snapshot asks for it. read returns Markdown, network lists requests since the session opened, and console needs captureConsole. code is JavaScript by default, with page a Playwright Page. Send statements, whose last expression or return value comes back as result, or a function such as async (page) => { ... }. With "language": "python", page is in scope and you set result. prompt is plain words for an agent. A call may take 30 seconds, and timeout raises that to 300. A session is billed from stophy_browser_open to stophy_browser_close, so tell your agent to close every browser it opens. The tools were named browserOpen, browserRun and so on until November 2026, and those names still work.

More tools and a local server

?toolsets=web on https://api.stophy.dev/mcp adds batches and more crawl and agent tools, such as batchScrape, crawlList and agentList. toolsets=browser adds stophy_browser_downloads, stophy_browser_recording, stophy_browser_proxy, stophy_browser_extensions, stophy_browser_network_policy, browserProfiles and browserTaskStatus. toolsets=webhook adds the webhook delivery tools. For an app that can only start a local server, npx -y @stophy/mcp (Node.js 18 or later) passes every request to the hosted server. Set STOPHY_API_KEY for every tool, and STOPHY_MCP_URL to change the server. Claude Desktop uses the connector above, not this package.

Check it

Ask your agent to search YouTube for rust tutorial and summarize the top three videos. If stophy shows no tools, restart your client.