Analyze one or more images using a vision-capable model from OpenRouter. Use this whenever you need to know what is in an image but you cannot see images yourself.

This is the Vision Helper MCP server's own analysis tool (distinct from any other vision server you may have configured). It loads the image(s) — from a URL, a local file path, a file:// URI, a data: URI, or raw base64 — and sends them to a vision model, then returns that model's analysis as text.

Security notes: local files are read and sent to OpenRouter only when explicitly requested; only image content is uploaded and only if it is a supported format (PNG, JPEG, WebP, or GIF, per OpenRouter). Remote URLs are validated against private/internal hosts and redirects before fetching.

Args:

• image (string | string[]): Image source(s). Accepted forms: http(s) URL, local file path, file:// URI, data: URI (data:image/png;base64,...), or raw base64. Pass an array to analyze several images together (e.g. to compare them). Relative file paths resolve against the MCP client's working directory — prefer absolute paths or URLs.

• prompt (string, optional): What the vision model should look for, e.g. 'Transcribe all text in this screenshot' or 'Describe the objects and colors'. Defaults to a general detailed description.

• model (string, optional): OpenRouter model ID, e.g. 'google/gemini-3.6-flash'. Defaults to the OPENROUTER_MODEL environment variable, then to 'google/gemini-3.6-flash'. Use vision_helper_list_models to see current options.

• max_tokens (number, optional): Max tokens for the answer (64-16000).

• temperature (number, optional): Sampling temperature (0-2).

Returns: Text containing the vision model's analysis, prefixed with the model and image sources used. Long analyses are truncated at 25000 characters with a marker.

Examples:

• "What is in this image? https://example.com/photo.jpg" -> image="https://example.com/photo.jpg"

• "Read the text in this screenshot: C:\Users\me\Pictures\shot.png" -> image="C:\Users\me\Pictures\shot.png"

• "Compare these two images: img1.png and img2.png" -> image=["img1.png", "img2.png"]

Error Handling:

• "Error: No OpenRouter API key found..." -> run vision_helper_check_config to see how keys are resolved.

• "Error: Model not found..." -> run vision_helper_list_models and pass a valid model id.

• "Error: Image is N bytes, which exceeds MAX_IMAGE_SIZE..." -> shrink the image or raise MAX_IMAGE_SIZE.

• "Error: ... only accept PNG, JPEG, WebP, or GIF ..." -> convert the image to a supported format.

List vision-capable models currently available on OpenRouter, so you (or the user) can pick which model to use for image analysis.

Models are filtered to those that accept image input. Use the 'search' argument to narrow by provider or family (e.g. 'gemini', 'claude', 'qwen', 'gpt'), and limit/offset for pagination.

Args:

• search (string, optional): Case-insensitive substring filter on model ID or name.

• limit (number, default 25, max 100): Maximum number of models to return.

• offset (number, default 0): Number of models to skip.

• response_format ('markdown' | 'json', default 'markdown'): Output style.

Returns: For 'markdown': a compact list of model IDs with provider, context length, and input price. For 'json': structured array with has_more / next_offset for pagination.

Examples:

• "Which vision models can I use?" -> no arguments

• "Find a fast cheap vision model" -> search="flash"

• "What vision models does Google offer?" -> search="google/gemini"

Diagnose why vision analysis may be failing. Reports whether an OpenRouter API key is configured, where it was loaded from (MCP client environment, Windows user environment variables, or Windows system environment variables), which model would be used by default, and the configured size/time limits.

The key is only shown masked (e.g. sk-or-v1-…a0) — never in full.

Args:

• (none)

Returns: A short markdown report with:

• API key: present or missing, plus the source it was resolved from.

• Default model: from OPENROUTER_MODEL, or the built-in default ('google/gemini-3.6-flash').

• MAX_IMAGE_SIZE and request timeout.

Examples:

• Use when vision_helper_analyze_image fails with "No OpenRouter API key found" to confirm where keys are (or are not) configured.