@houndmcp/hound-mcp-pi

extensionmaintained

Hound web research for Pi agent - keyless search, anti-bot fetch, deep crawl, screenshot, Internet Archive dead-link recovery. Free, MIT, no API key.

by · v12.4.1 · published 2w ago

$ pi install npm:@houndmcp/hound-mcp-pi
downloads/mo
5.0K
stars
786
last push
2w ago
open issues
11

Signals

license: MITtestspi manifest: missinginstall size: —deps: 0peer deps: 0

Download trend

No downloads in the last 12 weeks.

README

hound-mcp-pi

Hound web research for the Pi agent. Six native tools, all routed through a single long-lived Hound MCP subprocess:

  • web_fetch - anti-bot fetch + clean extraction + Internet Archive dead-link recovery
  • web_search - keyless web search across 10 backends, neural-reranked
  • web_crawl - deep site crawl, sitemap one-fetch map
  • web_screenshot - anti-bot screenshot for multimodal agents
  • cache_clear - clear fetch cache
  • hound_version - version + update status

Install

# 1. Install Hound (the MCP server / engine)
pip install hound-mcp[all]

# 2. Install this Pi extension (npm, auto-updates)
pi install npm:@houndmcp/hound-mcp-pi

Alternatively, install from git (pins to a specific tag):

pi install git:github.com/dondai1234/master-fetch@v10.3.0

That's it. The extension auto-discovers hound on your PATH, spawns it as a singleton subprocess, and prewarms it at session start. No API key, no account, no config file.

Updating

# Update Hound (the MCP server)
hound -u

# Update the Pi extension (if installed via npm, unpinned)
pi update npm:@houndmcp/hound-mcp-pi

The extension checks at session start whether the installed Hound version matches the extension version. If they diverge by a major version, it warns you to update both.

How it works

The extension spawns hound (the MCP server) as a stdio subprocess and speaks MCP JSON-RPC to it. The subprocess is a singleton — it stays alive for the whole Pi session, so Hound's startup prewarm (stealthy browser, search engines, neural reranker) runs once and persists. Zero re-launch cost per call.

Requirements

  • Pi coding agent
  • Python 3.11+ with hound-mcp[all] installed (pip install hound-mcp[all])

License

MIT. Same as Hound itself.