Tool reference

generate_image

Generate Image. Generate one image, or edit one, and get back its url.

GroupAccessMCP name
NotesWrites datagenerate_image

Description

The description the MCP server sends to the model, word for word. Its rules apply to every call.

Generate one image, or edit one, and get back its url. Use it when the user asks for an image for a note, or agrees to one you offered, for example because the note is for a platform whose rules say needsImage (see list_buffer_channels). Write the note first, then write a full, specific prompt drawn from what that note says. Pick quality yourself: low for drafts and simple graphics, medium when the image is final or has text in it. Pick aspect from the channel's rules.imageAspect, or square. To put the image on a note, pass the returned url as imageUrl to create_note, create_many_notes or update_note. For several notes, call this once per note; up to three run at a time. To edit an image, pass its url in referenceImageUrls (only urls this tool returned) and describe the change. Each image counts against the user's weekly Coach usage; when that is used up the call fails and says when it resets.

Arguments

ArgumentTypeRequiredDescription
aspectstringNosquare for notes and most social posts. portrait for phone-first posts. landscape for article headers and thumbnails. One of: "square", "portrait", "landscape". Default "square".
promptstringYesWhat the image shows: subject, setting, style, colors, and any text that must appear in it, spelled exactly. Min length 3. Max length 4000.
qualitystringYeslow for quick drafts, simple graphics, and variations to choose from. medium for a final image, fine detail, or text inside the image. One of: "low", "medium".
referenceImageUrlsstring[]NoImages to edit or match, by url: the Attached image urls listed in the writer's messages, or urls generate_image returned. Pass every logo, product shot, or person the writer wants in the image; describing them in the prompt is not enough. Leave empty to start from text. Max items 4. Format uri.

Example call

The smallest valid request: required arguments only, with placeholder values.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_image",
    "arguments": {
      "prompt": "…",
      "quality": "low"
    }
  }
}

Result

The result has structuredContent that matches this schema. The same data is also in content as JSON text.

FieldTypeRequiredDescription
mediaTypestringYes
sizestringYes
urlstringYes

Annotations

HintValue
readOnlyHintfalse
destructiveHintfalse
openWorldHinttrue

The full input and output JSON Schemas for every tool are in /mcp-tools.json.

On this page