Stophy

io.github.stophydotdevPublished by GitHub account stophydotdevv1.3.1Updated Nov 7, 2026

Give your agents the live web.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBrowser Automation

Overview

AI-generated overview

Stophy gives an assistant live web data: search, scrape, map, crawl and extract pages, plus run paid data endpoints, through a hosted or local MCP server.

What you can do
  • Search the web, news, images, scholarly papers, companies and people
  • Read a page as markdown, HTML, links, a screenshot or JSON, including site-specific parsers for structured data
  • List a site's pages, crawl a site in the background and check crawl status
  • Pull named fields from pages as JSON
  • Find, describe and run data endpoints by id, with cost shown per call
  • Start a signup flow that returns a claim link and then an API key
When to use it
Use it when an assistant needs current web content rather than model memory: research, monitoring pages, collecting site data, or pulling structured fields from public pages. It suits workflows that need search plus reading and extraction in one place.
Requirements
Either the hosted endpoint (with browser sign-in or an Authorization bearer token) or the local npm package @stophy/mcp, which needs Node.js 18 or later and forwards requests to the hosted server. An optional STOPHY_API_KEY unlocks every endpoint; without it only keyless endpoints work, at 10 requests a minute and 50 a day per IP. Network access to the Stophy host is required.
Before you install
Calls cost credits and therefore money: most calls cost 1 credit, search 2 credits per 10 results, crawl 1 credit a page, extract 5 credits for most pages, and optional extras such as checkPromptInjection add 4 credits. The API key is a billable secret passed as STOPHY_API_KEY or an Authorization bearer token. The signup tool returns a claim link that a person must approve. Page content and URLs are sent to the Stophy service.

Installation

In SourceWeft

  1. Open Stophy in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.stophydotdev%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "stophy": {
      "type": "http",
      "url": "https://api.stophy.dev/mcp"
    }
  }
}

README

Stophy 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.

[Add to Cursor]

Connect to the hosted server

Most apps connect to the hosted server directly, with nothing to install.

URLHow you connectWhat your agent can use
https://api.stophy.dev/mcpNo keyThe endpoints marked keyless: true in the endpoint list, within a free allowance
https://api.stophy.dev/mcpAuthorization: Bearer <key> headerEvery endpoint
https://mcp.stophy.dev/mcpSign in with your browserEvery 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:

bash
claude mcp add --transport http stophy https://mcp.stophy.dev/mcp

To use an API key:

bash
claude mcp add --transport http stophy https://api.stophy.dev/mcp --header "Authorization: Bearer <key>"

To start without a key:

bash
claude mcp add --transport http stophy https://api.stophy.dev/mcp

Codex

To use the key in your STOPHY_API_KEY environment variable:

bash
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:

bash
codex mcp add stophy --url https://mcp.stophy.dev/mcpcodex 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:

json
{  "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.

bash
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:

json
{  "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.

VariableWhat it does
STOPHY_API_KEYYour Stophy API key. Optional.
STOPHY_MCP_URLThe server to connect to. The default is https://api.stophy.dev/mcp.

Tools

ToolWhat it does
stophy_searchSearches the web, news and images
stophy_scrapeReads a page as markdown, HTML, links, a screenshot or JSON
stophy_mapLists the pages on a site
stophy_crawlStarts a crawl of a site in the background and returns its id
stophy_extractPulls the fields you name from pages as JSON
stophy_search_endpointsFinds the endpoint for a task, with its cost. Free
stophy_describe_endpointShows an endpoint's inputs, an example and what it returns. Free
stophy_callRuns any endpoint by id with input, and optional fields and maxTextLength
stophy_signupGets 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:

json
{  "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) and https://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_KEY that you set yourself. The local package also reads an optional STOPHY_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

Source: mcp/README.md at commit 73d998d

Tools

9

stophy_search_endpoints

Find Stophy endpoints

Start here. Send plain words for the data you want. Returns endpoints with their inputs, filters and cost, ready for stophy_call. Costs nothing.

Parametersquerycategory

stophy_describe_endpoint

Describe a Stophy endpoint

Optional. Returns an endpoint's full inputs, filter notes, an example and output fields. Costs nothing.

Parametersidrequired

stophy_call

Call a Stophy endpoint

Send an endpoint id and its input. Returns the data and what the call cost.

ParametersidrequiredinputfieldsmaxTextLength

stophy_scrape

Web Scrape

Scrape any public web page as markdown, HTML, links, a screenshot or JSON. 1 credit for any page, however it is reached. checkPromptInjection adds 4 credits when the scan runs, json with a schema or a prompt, summary, highlights, question, product, menu and changeTracking in json mode add 4 credits each when they return something. CSS rules and attributes add nothing. A PDF adds 1 credit for each page read. Browser actions add nothing. An answer from a stored copy within maxAge costs 1 credit like any page. A page that comes back with a 404 or 410 status is charged like any page. A page that cannot be read costs nothing. creditsUsed shows what the call cost. To get a site's own data as JSON, send the site's page URL with formats [{"type":"json","parser":"<name>"}] and put extra inputs such as page or filters in options. Some sites can only be read this way. Parsers: google-maps, google-maps-place, google-maps-reviews, google-trends, google-scholar, google-patents, google-ads, google-flights, google-hotels, google-play-app, google-play-search, google-play-reviews, upwork-search, upwork-job, craigslist-search, craigslist-listing, careers-jobs, careers-job, indeed-search, indeed-job, realtor-search, realtor-property, zillow-search, zillow-property, expedia-hotels, booking-search, booking-hotel, booking-reviews, airbnb-search, airbnb-listing, airbnb-reviews, youtube-search, youtube-video, youtube-transcript, youtube-comments, youtube-channel, youtube-post, youtube-playlist, reddit-search, reddit-post, reddit-subreddit, reddit-user, reddit-subreddits, instagram-post, instagram-profile, instagram-comments, instagram-transcript, instagram-feed, x-profile, x-post, threads-profile, threads-post, pinterest-search, pinterest-pin, pinterest-board, pinterest-profile, facebook-page, facebook-post, facebook-comments, facebook-marketplace, tiktok-video, tiktok-comments, tiktok-transcript, tiktok-profile, tiktok-hashtag, tiktok-sound, tiktok-search, tiktok-ads, tiktok-shop, tiktok-f

ParametersurlrequiredurlsproxymaxAgeminAgemobileactionsformatsheadersparsersprofiletimeout+24 more

stophy_map

Web Map

Scrape the list of pages on a website. 1 credit per call. Input: url, search, sitemap, includeSubdomains, ignoreQuery...

ParametersurlrequiredlimitsearchsitemaptimeoutlocationalexandriadomainToolsignoreCacheauditMetadataignoreRobotsTxtrobotsUserAgent+3 more

stophy_crawl

Web Crawl Start

Crawl a website in the background. 1 credit a page, however it is reached. checkPromptInjection adds 4 credits when t...

ParametersurlrequireddelaylimitpromptsitemapwebhookalexandriadomainToolsexcludePathsincludePathsauditMetadatascrapeOptions+12 more

stophy_extract

Web Extract

Pull the fields you name from any public page as JSON, each checked against the page. 5 credits for most pages: the p...

ParametersurlspromptschemaalexandriadomainToolsshowSourcesauditMetadataignoreSitemapscrapeOptionsenableWebSearchignoreRobotsTxtrobotsUserAgent+4 more

stophy_signup

Get a Stophy API key

Needs no key. Returns a claimUrl for your person to approve and a secret code. Call it again with the code to collect the key once they approve. Returns at once, so call again later.

Parameterscode

Version history

11
  1. v1.3.1LatestNov 7, 2026
  2. v1.3.0Nov 3, 2026
  3. v2.0.9Oct 10, 2026
  4. v2.0.8Oct 2, 2026
  5. v2.0.6Oct 2, 2026
  6. v2.0.5Oct 2, 2026
  7. v2.0.4Oct 2, 2026
  8. v2.0.3Oct 1, 2026
  9. v2.0.2Sep 30, 2026
  10. v2.0.1Sep 29, 2026
  11. v2.0.0Sep 29, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.