Stophy is an MCP server published by io.github.stophydotdev, hosted at api.stophy.dev. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 5 tools, including stophy_scrape, stophy_search, stophy_map, stophy_parse, stophy_signup.
Search, read, and act on the web. The Stophy MCP server for agents.
7 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Scrape any public web page as markdown, HTML, links, a screenshot or JSON. For fields from any page, send formats [{"type":"json","prompt":"..."}] or a schema; this needs an API key. For a site's own data, send its page URL with formats [{"type":"json","parser":"<name>"}] and the parser's inputs, such as page, in options. Some sites can only be read this way. Parsers: google: maps, maps-place, maps-reviews, trends, patents, ads, flights, hotels, play-app, play-search, play-reviews; upwork: search, job; craigslist: search, listing; careers: jobs, job; indeed: search, job; realtor: search, property; zillow: search, property; expedia: hotels; booking: search, hotel, reviews; airbnb: search, listing, reviews; youtube: search, video, transcript, comments, channel, post, playlist; reddit: search, post, subreddit, user, subreddits; instagram: post, profile, comments, transcript, feed; x: profile, community, post; threads: profile, post; pinterest: search, pin, board, profile; facebook: page, group, post, comments, marketplace; tiktok: video, comments, transcript, profile, hashtag, sound, search, ads, shop, followers, following, trending, live; linkedin: jobs, job, company, profile, posts, ads; meta: ads; amazon: product, reviews, search, bestsellers; ebay: search, item; appstore: app, reviews, search, top; trustpilot: company, reviews, search; yelp: business, reviews, search; tripadvisor: search, place, reviews; glassdoor: company, reviews, salaries; crunchbase: company; g2: reviews; luma: events, event; emails; phone: numbers; bsky: profile, post; link: in-bio; twitch: profile, clips. Also takes onlyCleanContent, minAge, headers, skipTlsVerification, removeBase64Images, imageUrls, allMetaTags, blockAds, fastMode, storeInCache, lockdown, checkPromptInjection, redactPII, profile, zeroDataRetention. Free without a key, within limits; with a key, $1 per 1,000 pages; JSON, summaries and PDF text cost more, and a parser has its own price.
| Parameter | Type | Description |
|---|---|---|
| url * | string | The page or PDF to read. |
| proxy | string | auto tries basic, then enhanced if refused. Same price. |
| query | string | What you look for; a long page comes back as the matching passages. |
| maxAge | integer | Oldest stored answer to accept, in ms. 0 reads live. |
| mobile | boolean | Read the page as a phone. |
| offset | integer | Start this many characters in; send the last nextOffset. |
| actions | array | Steps to run on the page before reading it, in order. |
| formats | array | What to return: names, or objects with a type. Default markdown. |
| timeout | integer | How long to keep trying, in ms. |
| waitFor | integer | Extra ms to wait before reading, up to 60000. |
| location | object | { country, languages } to read from. Default US. |
| maxChars | integer | Cut the markdown at this many characters; nextOffset says where to read on. |
| linkStyle | string |
{
"name": "stophy_scrape",
"title": "Web Scrape",
"description": "Scrape any public web page as markdown, HTML, links, a screenshot or JSON. For fields from any page, send formats [{\"type\":\"json\",\"prompt\":\"...\"}] or a schema; this needs an API key. For a site's own data, send its page URL with formats [{\"type\":\"json\",\"parser\":\"<name>\"}] and the parser's inputs, such as page, in options. Some sites can only be read this way. Parsers: google: maps, maps-place, maps-reviews, trends, patents, ads, flights, hotels, play-app, play-search, play-reviews; upwork: search, job; craigslist: search, listing; careers: jobs, job; indeed: search, job; realtor: search, property; zillow: search, property; expedia: hotels; booking: search, hotel, reviews; airbnb: search, listing, reviews; youtube: search, video, transcript, comments, channel, post, playlist; reddit: search, post, subreddit, user, subreddits; instagram: post, profile, comments, transcript, feed; x: profile, community, post; threads: profile, post; pinterest: search, pin, board, profile; facebook: page, group, post, comments, marketplace; tiktok: video, comments, transcript, profile, hashtag, sound, search, ads, shop, followers, following, trending, live; linkedin: jobs, job, company, profile, posts, ads; meta: ads; amazon: product, reviews, search, bestsellers; ebay: search, item; appstore: app, reviews, search, top; trustpilot: company, reviews, search; yelp: business, reviews, search; tripadvisor: search, place, reviews; glassdoor: company, reviews, salaries; crunchbase: company; g2: reviews; luma: events, event; emails; phone: numbers; bsky: profile, post; link: in-bio; twitch: profile, clips. Also takes onlyCleanContent, minAge, headers, skipTlsVerification, removeBase64Images, imageUrls, allMetaTags, blockAds, fastMode, storeInCache, lockdown, checkPromptInjection, redactPII, profile, zeroDataRetention. Free without a key, within limits; with a key, $1 per 1,000 pages; JSON, summaries and PDF text cost more, and a parser has its own price.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The page or PDF to read."
},
"proxy": {
"enum": [
"auto",
"basic",
"enhanced",
"stealth"
],
"type": "string",
"description": "auto tries basic, then enhanced if refused. Same price."
},
"query": {
"type": "string",
"description": "What you look for; a long page comes back as the matching passages."
},
"maxAge": {
"type": "integer",
"description": "Oldest stored answer to accept, in ms. 0 reads live."
},
"mobile": {
"type": "boolean",
"description": "Read the page as a phone."
},
"offset": {
"type": "integer",
"description": "Start this many characters in; send the last nextOffset."
},
"actions": {
"type": "array",
"items": {
"type": "object",
"description": "Objects with a type: wait (milliseconds, selector), click (selector, all), write (text), press (key), scroll (direction, amount, maxScrolls, selector), screenshot (fullPage, quality, viewport), scrape, executeJavascript (script), pdf (format, landscape, scale), perform (action)."
},
"maxItems": 50,
"description": "Steps to run on the page before reading it, in order."
},
"formats": {
"type": "array",
"items": {
"anyOf": [
{
"enum": [
"markdown",
"summary",
"html",
"rawHtml",
"rawBase64",
"links",
"images",
"network",
"branding",
"audio",
"video",
"screenshot",
"changeTracking",
"product",
"menu"
],
"type": "string"
},
{
"type": "object",
"description": "Objects with a type: changeTracking (modes, schema, prompt, tag), question (question), product, menu, screenshot (fullPage, quality, viewport), highlights (query, count), json (parser, options, schema, prompt, rules, checkPromptInjection), attributes (selectors)."
}
]
},
"maxItems": 20,
"description": "What to return: names, or objects with a type. Default markdown."
},
"timeout": {
"type": "integer",
"maximum": 300000,
"minimum": 1000,
"description": "How long to keep trying, in ms."
},
"waitFor": {
"type": "integer",
"maximum": 60000,
"description": "Extra ms to wait before reading, up to 60000."
},
"location": {
"type": "object",
"description": "{ country, languages } to read from. Default US."
},
"maxChars": {
"type": "integer",
"maximum": 1000000,
"minimum": 500,
"description": "Cut the markdown at this many characters; nextOffset says where to read on."
},
"linkStyle": {
"enum": [
"inline",
"numbered",
"none"
],
"type": "string",
"description": "none (default here) keeps link text only; inline keeps [text](address); numbered lists addresses at the end."
},
"excludeTags": {
"type": "array",
"items": {
"type": "string"
},
"description": "CSS selectors to drop, such as .comments."
},
"includeTags": {
"type": "array",
"items": {
"type": "string"
},
"description": "CSS selectors to keep, such as article."
},
"onlyMainContent": {
"type": "boolean",
"description": "Default true: leaves out menus, headers and footers."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"creditsUsed",
"costUsd",
"requestId"
],
"properties": {
"costUsd": {
"type": "number"
},
"success": {
"type": "boolean",
"const": true
},
"requestId": {
"type": "string"
},
"creditsUsed": {
"type": "number"
}
}
},
"annotations": {
"title": "Web Scrape",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Search the web, news, images, scholarly papers and YouTube videos in one call. Also takes maxAge, country, lang, safe, timeout, ignoreInvalidURLs. Free without a key, within limits; with a key, $0.001 per 10 results from each source; pages it reads cost as in stophy_scrape.
| Parameter | Type | Description |
|---|---|---|
| tbs | string | Time filter: qdr:d, qdr:w, qdr:m or qdr:y. sbd:1 sorts newest first. |
| limit | integer | Results for each source. Default 10. |
| query * | string | What to search for. Operators such as site:, -word and quotes work. |
| sources | array | web (default), news, images. |
| location | string | Where to search from, such as Germany. |
| categories | array | pdf, research (papers) or videos (YouTube). |
| highlights | boolean | true makes description the passages that match the query, where we can. |
| scrapeLimit | integer | Read only the top this many results. |
| scrapeOptions | object | stophy_scrape options for each page, such as formats. With formats, each result's page is read. |
Scrape the list of pages on a website. Also takes ignoreQueryParameters, deduplicateSimilarURLs, ignoreCache, timeout, location. Free without a key, within limits; with a key, $0.50 per 1,000 calls.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Any page of the site. |
| limit | integer | Most addresses, up to 100000. |
| search | string | Keep addresses that mention these words, best first. |
| sitemap | string | include (default) uses sitemaps and links, only uses sitemaps, skip links. |
| includeSubdomains | boolean |
{
"name": "stophy_map",
"title": "Web Map",
"description": "Scrape the list of pages on a website. Also takes ignoreQueryParameters, deduplicateSimilarURLs, ignoreCache, timeout, location. Free without a key, within limits; with a key, $0.50 per 1,000 calls.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Any page of the site."
},
"limit": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Most addresses, up to 100000."
},
"search": {
"type": "string",
"description": "Keep addresses that mention these words, best first."
},
"sitemap": {
"enum": [
"skip",
"include",
"only"
],
"type": "string",
"description": "include (default) uses sitemaps and links, only uses sitemaps, skip links."
},
"includeSubdomains": {
"type": "boolean"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"creditsUsed",
"costUsd",
"requestId"
],
"properties": {
"costUsd": {
"type": "number"
},
"success": {
"type": "boolean",
"const": true
},
"requestId": {
"type": "string"
},
"creditsUsed": {
"type": "number"
}
}
},
"annotations": {
"title": "Web Map",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Turn a PDF, Word, Excel, PowerPoint or HTML file, or a picture of text, into markdown. Also takes onlyMainContent, includeTags, excludeTags, removeBase64Images, zeroDataRetention. Free without a key, within limits; with a key, $0.50 per 1,000 pages with a text layer, $2.50 per 1,000 pages read from a picture.
| Parameter | Type | Description |
|---|---|---|
| file | string | The file as base64, up to 36 MB: PDF, DOCX, XLSX, PPTX, HTML or a picture. |
| formats | array | Besides markdown: summary, html, rawHtml, links, images, or { type: json, schema or prompt }. |
| parsers | array | [{ "type": "pdf", "mode": "fast" | "auto" | "ocr", "maxPages" }] for PDFs. |
| filename | string | Its name, such as report.docx. |
| maxPages | integer | Most PDF pages, sheets or slides to read. |
{
"name": "stophy_parse",
"title": "Web Parse",
"description": "Turn a PDF, Word, Excel, PowerPoint or HTML file, or a picture of text, into markdown. Also takes onlyMainContent, includeTags, excludeTags, removeBase64Images, zeroDataRetention. Free without a key, within limits; with a key, $0.50 per 1,000 pages with a text layer, $2.50 per 1,000 pages read from a picture.",
"inputSchema": {
"type": "object",
"properties": {
"file": {
"type": "string",
"description": "The file as base64, up to 36 MB: PDF, DOCX, XLSX, PPTX, HTML or a picture."
},
"formats": {
"type": "array",
"items": {
"anyOf": [
{
"anyOf": [
{
"enum": [
"markdown",
"summary",
"html",
"rawHtml",
"links",
"images"
],
"type": "string"
},
{
"type": "object"
}
]
},
{
"type": "object",
"description": "Objects with a type: json (prompt, schema)."
}
]
},
"maxItems": 8,
"description": "Besides markdown: summary, html, rawHtml, links, images, or { type: json, schema or prompt }."
},
"parsers": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 1,
"description": "[{ \"type\": \"pdf\", \"mode\": \"fast\" | \"auto\" | \"ocr\", \"maxPages\" }] for PDFs."
},
"filename": {
"type": "string",
"description": "Its name, such as report.docx."
},
"maxPages": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Most PDF pages, sheets or slides to read."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"creditsUsed",
"costUsd",
"requestId"
],
"properties": {
"costUsd": {
"type": "number"
},
"success": {
"type": "boolean",
"const": true
},
"requestId": {
"type": "string"
},
"creditsUsed": {
"type": "number"
}
}
},
"annotations": {
"title": "Web Parse",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| code | string | The code from an earlier signup. Send it to collect the key once approved. |
{
"name": "stophy_signup",
"title": "Get a Stophy API key",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "The code from an earlier signup. Send it to collect the key once approved."
}
}
}
}Live web data for the user's task. stophy_search finds pages, stophy_scrape reads one, stophy_map lists a site's pages and stophy_parse reads a file. For a site's own data (video, social, places, reviews, jobs, shopping, homes, stays, apps, travel, ads), call stophy_scrape with the page URL and a parser named in its description; some sites can only be read this way. Calls without an API key are free within limits. Without an API key only Web Map, Web Parse, Web Scrape and Search work, at 10 requests a minute and 50 a day per IP. Call stophy_signup for a claim link your person approves. Then add the key as a bearer token to reach every endpoint.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| none (default here) keeps link text only; inline keeps [text](address); numbered lists addresses at the end. |
| excludeTags | array | CSS selectors to drop, such as .comments. |
| includeTags | array | CSS selectors to keep, such as article. |
| onlyMainContent | boolean | Default true: leaves out menus, headers and footers. |
| excludeDomains | array |
| includeDomains | array |
{
"name": "stophy_search",
"title": "Search",
"description": "Search the web, news, images, scholarly papers and YouTube videos in one call. Also takes maxAge, country, lang, safe, timeout, ignoreInvalidURLs. Free without a key, within limits; with a key, $0.001 per 10 results from each source; pages it reads cost as in stophy_scrape.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"tbs": {
"type": "string",
"description": "Time filter: qdr:d, qdr:w, qdr:m or qdr:y. sbd:1 sorts newest first."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results for each source. Default 10."
},
"query": {
"type": "string",
"description": "What to search for. Operators such as site:, -word and quotes work."
},
"sources": {
"type": "array",
"items": {
"anyOf": [
{
"enum": [
"web",
"news",
"images"
],
"type": "string"
},
{
"type": "object",
"description": "Objects with a type: web (tbs, location, country, lang)."
}
]
},
"maxItems": 5,
"description": "web (default), news, images."
},
"location": {
"type": "string",
"description": "Where to search from, such as Germany."
},
"categories": {
"type": "array",
"items": {
"anyOf": [
{
"enum": [
"research",
"pdf",
"videos"
],
"type": "string"
},
{
"type": "object"
}
]
},
"description": "pdf, research (papers) or videos (YouTube)."
},
"highlights": {
"type": "boolean",
"description": "true makes description the passages that match the query, where we can."
},
"scrapeLimit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Read only the top this many results."
},
"scrapeOptions": {
"type": "object",
"description": "stophy_scrape options for each page, such as formats. With formats, each result's page is read."
},
"excludeDomains": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10
},
"includeDomains": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10
}
}
},
"outputSchema": {
"type": "object",
"required": [
"creditsUsed",
"costUsd",
"requestId"
],
"properties": {
"costUsd": {
"type": "number"
},
"success": {
"type": "boolean",
"const": true
},
"requestId": {
"type": "string"
},
"creditsUsed": {
"type": "number"
}
}
},
"annotations": {
"title": "Search",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}