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 theapi.stophy.dev URL.
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 inSTOPHY_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 onlystophy_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 forrust tutorial and summarize the top three videos. If stophy shows no tools, restart your client.