
Hound MCP Server: Web Search and Page Fetching for Claude, Cursor and Other Apps
Lets your assistant search the web, read pages and PDFs, and crawl sites from your own computer, with no API key.
Hound lets Claude, Cursor and other assistants search the web, read pages and PDFs, crawl sites and take screenshots from your own computer. It needs no account or API key. You install it with pip and add it to your app as a local program. The project says it is no longer maintained, so check the safety section before you rely on it.
Good for
- Claude Code, Cursor and OpenCode users who want free web search and page reading
- Researchers who need PDFs, including scanned ones, read page by page
- Developers who want a local fetch tool instead of a paid scraping service
- Anyone who wants pages fetched from their own machine, not a hosted service
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install Hound MCP
Claude Code
- 1
Copy this prompt.
Add the Hound MCP server to Claude Code. Run this command: claude mcp add hound -- hound Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Python 3.11+, pip install "hound-mcp[all]", playwright install chromium.
Read-only mode: There is no read-only mode.
Run the two commands under Requires first. The [all] extra adds the stealth browser, PDF reading and scanned-page OCR. Plain pip install hound-mcp works too but fetches without a browser. Your app runs the hound command with no arguments, as the README describes. Wrapping it in uvx hound-mcp does not match the README. Version 13.0.0 and later come from the dondai44423/master-fetch fork, so check the safety section before installing.
Built from the package data we hold. Not yet tested by us. Source.
Tools
Searches the web and returns links with snippets
Runs a web search across many search engines at once and merges the results into one ranked list. It returns links and short snippets, not page text, so the assistant follows up by fetching the best ones. Search keys you add yourself are used first if you set them up.
Try: “Search the web for recent benchmarks of local embedding models and give me the five best links.”
Network ·
mcp_smart_searchReads a web page or PDF and returns clean text
Loads a web address and returns its text as markdown. It starts with a plain request and switches to a stealth browser when the site blocks it. It can read PDFs by page, fetch several addresses in one call, keep only the passages that match a question, and click or fill in a page before reading it.
Try: “Read https://example.com/whitepaper.pdf and pull out only the paragraphs about pricing.”
Network ·
mcp_smart_fetchWalks through a site and reads many pages
Starts at one address and follows links on the same site, returning each page as text. It can list a site's pages from its sitemap first so the assistant picks which ones to read. It stops at 10 pages and 2 levels deep unless told otherwise.
Try: “Crawl the docs site at docs.example.com and read the pages about authentication.”
Network ·
mcp_smart_crawlTakes a picture of a web page
Opens a page in the stealth browser and returns a screenshot as an image. It suits pages where the layout, charts or images carry the meaning, and only works with assistants that can look at images.
Try: “Take a screenshot of example.com/pricing so I can see how the plans are laid out.”
Network ·
mcp_screenshotDeletes Hound's saved copies of pages
Hound keeps fetched text on your computer for an hour so repeat requests are fast. This tool removes the expired copies, or every saved copy when told to wipe all of them. It does not touch anything outside Hound's own cache.
Try: “Clear Hound's page cache so the next fetch is fresh.”
Delete ·
cache_clearShows the installed Hound version
Reports which Hound version is running and whether a newer one exists on PyPI. Useful for checking the setup took effect.
Try: “Which version of Hound is running, and is there an update?”
Network ·
version
Read from the source code
Permissions
medium risk · 8 things to watch
Medium risk
The assistant can load any public web page and click or type in a real browser, and the version you get from pip comes from a different GitHub account than the main repo. Our advice: check that account before you install, and keep it away from sites where you are logged in.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Published from a different GitHub account
The pip package links to dondai44423/master-fetch from version 13.0.0 on, while this page's main repo is dondai1234/master-fetch (897 stars). The changelog says the original account was locked and development moved. Verify before installing; our advice is to pin 12.4.1 if you want code that matches the original repo. github.com
It can click and fill forms on web pages
The fetch tool accepts click, fill, press, wait and scroll steps that run in a real browser before reading. The browser uses a throwaway profile, not your own, but a page you open can still receive form input. github.com
The author says Hound is abandoned
The fork README says Hound is no longer maintained and points to a Rust rewrite called DonSeTch. The last release was 13.2.0 on August 26, 2026, so expect no security fixes. github.com
Fetched pages can carry hidden instructions
Our advice: treat page text as untrusted, because a hostile page can include wording aimed at your assistant. Do not let it act on instructions it finds in fetched pages. github.com
It ignores robots.txt unless asked
Hound checks a site's robots.txt only when the request sets respect_robots. It also tries to get past bot checks, so follow each site's terms yourself. github.com
Your search terms go to many search engines
One search sends the query to eight search engines at once, plus Semantic Scholar, GitHub or Hacker News when the question fits. Do not search for anything you would not type into those sites. github.com
It keeps a local cache and can delete it
Fetched text is saved on your computer, and cache_clear deletes those saved copies. It does not delete anything outside Hound's own cache. github.com
Search keys and proxies are stored as plain text
If you add your own search keys or proxies, they are saved as plain JSON files in ~/.hound. Use file permissions or environment variables on a shared machine. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | There is no read-only switch. The server's command-line flags are --http, --host, --port and --cache-ttl. |
|---|---|
| Talks to | Any public web address the assistant asks it to open. Search engines: DuckDuckGo, Brave, Mojeek, Yahoo, Yandex, Startpage, Google, Qwant. Semantic Scholar, GitHub Search and Hacker News for matching queries. pypi.org when you check the version |
| Sign-in and keys | No account or API key. Optional search keys you add are stored as plain text in ~/.hound/search_keys.json. |
| Data retention | Fetched page text is cached on your computer in ~/.master_fetch_cache, for one hour by default. |
Questions
Is Hound official?
No. It is a community project by Bishesh Bhandari, published under the GitHub accounts dondai1234 and dondai44423. It is not made by any search engine or website it reads.
Is Hound still maintained?
No. The author marked it abandoned on September 6, 2026 and points to a Rust rewrite called DonSeTch. The last release was 13.2.0 on August 26, 2026, and the tool still works. Our advice: use DonSeTch for new setups, and if you stay on Hound, expect no security fixes.
Why are there two Hound GitHub repos?
The original repo is dondai1234/master-fetch. The changelog says that account was locked and the project moved to dondai44423/master-fetch from version 13.0.0. The pip package now links to the second repo.
Is Hound free?
Yes. It is MIT licensed and needs no account or API key. You can add paid search keys such as Serper or Tavily if you want them, but nothing requires them.
How do I add Hound to Claude?
Install it with the two commands in the install box, then follow the Claude Code or Claude Desktop tab. Claude Desktop may need the full path that which hound prints (macOS, Linux) or where hound prints (Windows).
Can it read my local files or reach my home network?
No. It only opens http and https addresses, and it blocks loopback and private network ranges. It does not read file:// addresses.
Is it safe to use?
Mostly, if you know what it can do. It reads any public page, can click and type in a browser, and ignores robots.txt unless asked. The bigger worry is that the project is no longer maintained.
Can it get past Cloudflare and bot checks?
The tool description says it starts with a plain request and moves to a stealth browser when a site blocks it. Results vary by site, and you stay responsible for following each site's terms.
Does Hound run locally or in the cloud?
Locally. Your assistant starts it as a program on your computer. An optional HTTP mode listens on 127.0.0.1 port 8765 by default.
What is @houndmcp/hound-mcp-pi on npm?
It is the extension for the Pi agent, not the MCP server. Install the server from PyPI first, then add the extension only if you use Pi.
Information
updated Nov 3, 2026
- Publisher
- Community
- Package
hound-mcp- Registry
- PyPI
- Transport
- stdio
- Auth
- None
- Version
- 13.2.0
- License
- MIT
- Last commit
- Jul 24, 2026
- Open issues
- 7
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 7Hide
- Hound README (original repo) · github.com
- Hound README (dondai44423 fork) · github.com
- Hound v13.2.0 server.py · github.com
- Hound v12.4.1 server.py · github.com
- Hound CHANGELOG (dondai44423 fork) · github.com
- hound-mcp on PyPI · pypi.org
- Hound v13.2.0 security.py · github.com