Skip to main content
Glama
CTlanston

visual-hunt-mcp

by CTlanston

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CHROME_CDP_ENDPOINTNoChrome remote-debugging endpointhttp://127.0.0.1:9222
VISUAL_HUNT_TIMEOUT_MSNoPer-page navigation/extraction timeout20000
VISUAL_HUNT_OUTPUT_ROOTNoRoot directory for downloaded images and manifestsprocess.cwd()
VISUAL_HUNT_AUTO_REGISTERNoSet to 1 to rewrite ~/.claude.json with this server entry on every startup
VISUAL_HUNT_MANUAL_PAGE_MAXNoHard cap on manual-page registry size; oldest evicted first50
VISUAL_HUNT_MANUAL_PAGE_TTL_MSNoTTL for entries in the manual-page registry; getManualPage refreshes1800000

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 sites as either an array of strings or a JSON-array string. Default quality suffix is 'cinematic' (kept for backwards-compat); reduce to 'normal' for noisy queries.

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 login_required or blocked, candidates is intentionally empty — log in via the connected Chrome window and re-extract with extract_manual_page_candidates.

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. candidates accepts either an array or a JSON-array string.

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. candidates accepts either an array or a JSON-array string.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

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