Enables AI agents to search, scrape, crawl, and extract data from the live web using specialized parsers.
Also known as stophydotdev/stophy, mcp, @stophy/mcp
- Stars
- 0
- Tools
- 9
- Downloads, 30 days
- —
- Latest version
- 1.3.1
- Last commit
- Nov 7, 2026
- License
- —
What is Stophy MCP?
Stophy enables AI agents to search, scrape, crawl, and extract data from the live web using specialized parsers. It exposes 9 tools, such as stophy_search, stophy_scrape, stophy_map.
Summary generated from the project's README
About Stophy MCP server
Stophy provides AI agents with the ability to interact with the live web through a variety of specialized tools. It allows agents to perform web searches, scrape content, map site structures, and crawl entire websites. Developers can use it to extract specific data fields as JSON or access structured data from platforms like Reddit, YouTube, or Google Maps using built-in parsers.
Users can connect to a hosted server via HTTPS using browser sign-in or an API key. For applications requiring a local setup, the @stophy/mcp package can be run via npx to proxy requests to the hosted service. The server supports several clients including Claude, Claude Code, Codex, and Cursor. While some endpoints are available for free within a specific allowance, full access to all tools requires an API key. The system tracks usage through a credit-based model where different actions like searching or crawling have specific costs.
What you can do with it
- 1Scrape content with specialized parsersHave an agent retrieve a YouTube transcript or Reddit search results as structured data.
Written from the project's README. Every use case is checked against a quote from it.
How to install Stophy MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Stophy MCP in Claude Code
$ claude mcp add --env 'STOPHY_API_KEY=<YOUR_STOPHY_API_KEY>' mcp -- npx -y @stophy/mcpInstall Stophy MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@stophy/mcp"
],
"env": {
"STOPHY_API_KEY": "<YOUR_STOPHY_API_KEY>"
}
}
}
}Install Stophy MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@stophy/mcp"
],
"env": {
"STOPHY_API_KEY": "<YOUR_STOPHY_API_KEY>"
}
}
}
}Install Stophy MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@stophy/mcp"],"env":{"STOPHY_API_KEY":"<YOUR_STOPHY_API_KEY>"}}'Install Stophy MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@stophy/mcp"
],
"env": {
"STOPHY_API_KEY": "<YOUR_STOPHY_API_KEY>"
}
}
}
}Install Stophy MCP in Codex
$ codex mcp add mcp --env 'STOPHY_API_KEY=<YOUR_STOPHY_API_KEY>' -- npx -y @stophy/mcpInstall Stophy MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@stophy/mcp"] [mcp_servers.mcp.env] STOPHY_API_KEY = "<YOUR_STOPHY_API_KEY>"
Install Stophy MCP in Gemini CLI
$ gemini mcp add -s user -e 'STOPHY_API_KEY=<YOUR_STOPHY_API_KEY>' mcp npx -- -y @stophy/mcpInstall Stophy MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@stophy/mcp"
],
"env": {
"STOPHY_API_KEY": "<YOUR_STOPHY_API_KEY>"
}
}
}
}Stophy MCP tools 9
Detected from the READMEstophy_searchstophy_scrapestophy_mapstophy_crawlstophy_extractstophy_search_endpointsstophy_describe_endpointstophy_callstophy_signup
Configuration
STOPHY_API_KEYSecretOptional Stophy API key for every tool. Without it, only the endpoints that need no key work, within a free allowance. Get one at https://stophy.dev/signup.
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablestophydotdev/stophy is public and reachablegithub.com/stophydotdev/stophy ↗Pass
- Package names this repository as its source@stophy/mcp names stophydotdev/stophy as sourcenpmjs.com/package/@stophy/mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @stophy/mcpnpmjs.com/package/@stophy/mcp/v/1.3.1#provenance ↗Pass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-07github.com/stophydotdev/stophy ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @stophy/mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 162 msPass
README
View on GitHubStophy MCP
Give your agents the live web over MCP. Your agent can search, scrape, map, crawl and extract, and read a site's own data through a parser.
Connect to the hosted server
Most apps connect to the hosted server directly, with nothing to install.
| URL | How you connect | What your agent can use |
|---|---|---|
https://api.stophy.dev/mcp |
No key | The endpoints marked keyless: true in the endpoint list, within a free allowance |
https://api.stophy.dev/mcp |
Authorization: Bearer <key> header |
Every endpoint |
https://mcp.stophy.dev/mcp |
Sign in with your browser | Every endpoint |
Get an API key at stophy.dev/signup.
Claude
In Claude on the web, Desktop or mobile, open Customize > Connectors, choose Add custom connector, and paste https://mcp.stophy.dev/mcp. Sign in when Claude asks.
Claude Code
To sign in with your browser, add the server, then run /mcp and choose Authenticate:
claude mcp add --transport http stophy https://mcp.stophy.dev/mcp
To use an API key:
claude mcp add --transport http stophy https://api.stophy.dev/mcp --header "Authorization: Bearer <key>"
To start without a key:
claude mcp add --transport http stophy https://api.stophy.dev/mcp
Codex
To use the key in your STOPHY_API_KEY environment variable:
codex mcp add stophy --url https://api.stophy.dev/mcp --bearer-token-env-var STOPHY_API_KEY
To sign in with your browser instead, add the sign-in URL, then log in:
codex mcp add stophy --url https://mcp.stophy.dev/mcp
codex mcp login stophy
Cursor
Use the Add to Cursor button above to sign in with your browser, or add this to .cursor/mcp.json to use a key:
{
"mcpServers": {
"stophy": {
"url": "https://api.stophy.dev/mcp",
"headers": { "Authorization": "Bearer <key>" }
}
}
}
To start without a key, leave out headers.
Run it as a local server
Some apps can only start a local MCP server. For those, use this package. It runs on your computer and passes every request to the hosted server, so it always has the same tools.
npx -y @stophy/mcp
With STOPHY_API_KEY set, your agent can use every endpoint. Without it, your agent can use the endpoints that need no key, within a free allowance.
Claude Desktop
Add this to claude_desktop_config.json, then restart Claude Desktop:
{
"mcpServers": {
"stophy": {
"command": "npx",
"args": ["-y", "@stophy/mcp"],
"env": { "STOPHY_API_KEY": "<key>" }
}
}
}
To start without a key, leave out env.
The package needs Node.js 18 or later.
| Variable | What it does |
|---|---|
STOPHY_API_KEY |
Your Stophy API key. Optional. |
STOPHY_MCP_URL |
The server to connect to. The default is https://api.stophy.dev/mcp. |
Tools
| Tool | What it does |
|---|---|
stophy_search |
Searches the web, news and images |
stophy_scrape |
Reads a page as markdown, HTML, links, a screenshot or JSON |
stophy_map |
Lists the pages on a site |
stophy_crawl |
Starts a crawl of a site in the background and returns its id |
stophy_extract |
Pulls the fields you name from pages as JSON |
stophy_search_endpoints |
Finds the endpoint for a task, with its cost. Free |
stophy_describe_endpoint |
Shows an endpoint's inputs, an example and what it returns. Free |
stophy_call |
Runs any endpoint by id with input, and optional fields and maxTextLength |
stophy_signup |
Gets your agent an API key: it returns a link for you to approve, then the key once you call it with the code |
To get a site's own data as JSON, such as a Reddit search, a YouTube transcript or Google Maps places, call stophy_scrape with the site's page URL and a parser:
{
"url": "https://www.reddit.com/search/?q=bun+runtime",
"formats": [{ "type": "json", "parser": "reddit-search" }]
}
The stophy_scrape description names every parser, and the parser list shows the page each one takes.
Endpoint ids are camelCase, such as crawlStatus or batchScrape. A crawl runs in the background: call crawlStatus through stophy_call with the crawl's id. While the crawl runs, the result has a next link: send the cursor value from that link as cursor to get the pages finished since. fields keeps only the keys you name on each row. Most calls cost 1 credit. Search costs 2 credits per 10 results, a crawl 1 credit a page, and extract 5 credits for most pages. Each result shows its cost in creditsUsed. See pricing.
To give each endpoint its own tool, add toolsets to the URL with a source name, such as https://api.stophy.dev/mcp?toolsets=web. Your agent then also gets scrape, crawlStatus, batchScrape and every other web endpoint as tools.
Network and credentials
- The hosted server lives at
https://mcp.stophy.dev/mcp(sign in) andhttps://api.stophy.dev/mcp(no key or an API key). Your client sends requests only there. - Credentials: browser sign-in handled by your MCP client, or an optional
STOPHY_API_KEYthat you set yourself. The local package also reads an optionalSTOPHY_MCP_URL. - The plugin manifests (
.mcp.json,.grok-plugin/plugin.json,mcp.json,plugin.json) only point at the hosted server. They run no code on your machine. - No telemetry.
More
License
MIT
Stophy MCP questions
How do I add Stophy MCP to Claude Code?
Run claude mcp add --env 'STOPHY_API_KEY=<YOUR_STOPHY_API_KEY>' mcp -- npx -y @stophy/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Stophy MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Stophy MCP provide?
It exposes 9 tools, including stophy_search, stophy_scrape, stophy_map, stophy_crawl, stophy_extract.
How can I use Stophy without an API key?
You can connect to the hosted server without a key to access endpoints marked as keyless within a free allowance.
Can I get structured data like Reddit searches or YouTube transcripts?
Yes, you can use the stophy_scrape tool with specific parsers to get a site's own data as JSON.