visual-hunt-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CHROME_CDP_ENDPOINT | No | Chrome remote-debugging endpoint | http://127.0.0.1:9222 |
| VISUAL_HUNT_TIMEOUT_MS | No | Per-page navigation/extraction timeout | 20000 |
| VISUAL_HUNT_OUTPUT_ROOT | No | Root directory for downloaded images and manifests | process.cwd() |
| VISUAL_HUNT_AUTO_REGISTER | No | Set to 1 to rewrite ~/.claude.json with this server entry on every startup | |
| VISUAL_HUNT_MANUAL_PAGE_MAX | No | Hard cap on manual-page registry size; oldest evicted first | 50 |
| VISUAL_HUNT_MANUAL_PAGE_TTL_MS | No | TTL for entries in the manual-page registry; getManualPage refreshes | 1800000 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_google_imagesA | Search Google Images (udm=2) for visually strong poster and wallpaper candidates using the connected local Chrome session. Default quality is 'normal' — pass 'cinematic' or 'poster' only when you actually want a stylistic suffix appended to the query (verbose suffixes can push Google to zero-results pages). |
| search_wallpaper_sitesA | Search supported wallpaper, photography, archive, and open-license image sources using direct site adapters with Google fallback. Pass |
| open_instagram_visual_searchA | Open Instagram in the connected local Chrome session for manual-assisted visual review and extract only visible images. When pageState.status is |
| open_xiaohongshu_visual_searchA | Open Xiaohongshu search results in the connected local Chrome session and extract visible images. Best path for Chinese-language queries. When pageState reports a login wall, candidates is empty — log in via Chrome and call extract_manual_page_candidates. |
| open_pinterest_visual_searchA | Open Pinterest pin search results in the connected local Chrome session and extract visible image candidates. Pinterest occasionally serves a login wall — log in via the connected Chrome window and call extract_manual_page_candidates to re-extract. |
| open_google_maps_visual_searchA | Open Google Maps in the connected local Chrome session for safe, manual-assisted visual inspiration review. Map tile URLs (maps/vt/...) are filtered out automatically; remaining Google-hosted preview URLs cannot be downloaded by this MCP. |
| open_url_and_extract_imagesA | Open any http or https URL in the connected local Chrome session and extract visible image candidates. javascript:, file:, and other schemes are rejected. |
| extract_manual_page_candidatesA | Re-extract visible image candidates from a previously opened manual-assisted page after you log in, scroll, or dismiss overlays. The manualPageId comes from a prior open_*_visual_search call. Each access refreshes the TTL. |
| close_manual_pageA | Close a previously opened manual-assisted page and remove it from the in-memory registry. Returns {closed:false} if the manualPageId was unknown (already closed or expired); not an error. |
| save_candidates_jsonA | Save candidate metadata under the current MCP working directory without downloading image files. |
| download_candidate_imagesA | Download candidate images into a project folder under the current MCP working directory, using the connected browser session for cookies and referer when needed. Google-hosted previews and Google Maps imagery are blocked. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/CTlanston/visual-hunt-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server