Generate an image from a text prompt. Returns the image itself.

HOW MANY reference_images you pass decides whether the model obeys you. This matters more than prompt wording:

0 refs -> art style and composition instructions are followed exactly. The look of any character must be described in words. 1 ref -> keeps the referenced character's likeness AND follows pose instructions, BUT the art style will follow the reference, not your prompt. Use for expression sets / same character, new pose. 3+ refs -> the model starts copying instead of creating. Pose and style instructions stop working; it reproduces the reference, including its background props and artifacts. Avoid.

Style control and likeness control cannot both be had in one call. Decide which one this image needs. To get both: generate once with 0 refs to fix the style, then use that output as the single ref for follow-ups.

Hard limit: 6 reference images, more returns HTTP 400.

Args: prompt: what to draw. Put the full art-style description here. reference_images: local file paths or public https URLs. Read the rule above. size: e.g. "1024x1024", or a tier like "1K" / "2K". ratio: e.g. "1:1", "16:9". save_path: where to write the png. Defaults to a temp file; the path is always reported so the user can find the file.

Look at one or more images and answer a question about them.

Gives vision to a text-only model. Useful for: reading text in a screenshot, describing a photo, checking whether a generated image matches a brief, comparing two images, extracting data from a chart.

Args: images: local file paths or public https URLs. question: what to ask about them. Be specific — "what error is shown in this screenshot" beats "describe this".

Set up this server with the user's API key. This is the whole install: save the key, then prove both capabilities actually work end to end.

Call this as soon as the user provides a key. Report the returned message back to them verbatim — it is the completion notice.

The key is verified before being written, so a typo fails here rather than on the first real request. It is stored in plain text at ~/.agnes-image-mcp-key on this machine only, and is sent only to Agnes. AGNES_API_KEY in the environment still wins if set.

Args: key: the Agnes API key, starting with "sk-". Free at https://agnes-ai.com. run_check: generate one small image and read it back to confirm both paths work. Takes 20-60s. Only skip it if the user is in a hurry.

List the models available on this API key, and which ones this server picks by default for generation and for vision.