# generate_image (/docs/build/mcp-reference/generate_image)

{/* GENERATED by scripts/generate-mcp-reference.mjs from the MCP server tools/list. Do not edit. */}

| Group | Access | MCP name |
| --- | --- | --- |
| Notes | Writes data | `generate_image` |

## Description [#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 [#arguments]

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `aspect` | `string` | No | square for notes and most social posts. portrait for phone-first posts. landscape for article headers and thumbnails. One of: `"square"`, `"portrait"`, `"landscape"`. Default `"square"`. |
| `prompt` | `string` | Yes | What the image shows: subject, setting, style, colors, and any text that must appear in it, spelled exactly. Min length 3. Max length 4000. |
| `quality` | `string` | Yes | low 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"`. |
| `referenceImageUrls` | `string[]` | No | Images 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 [#example-call]

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

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

## Result [#result]

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

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `mediaType` | `string` | Yes |  |
| `size` | `string` | Yes |  |
| `url` | `string` | Yes |  |

## Annotations [#annotations]

| Hint | Value |
| --- | --- |
| `readOnlyHint` | `false` |
| `destructiveHint` | `false` |
| `openWorldHint` | `true` |

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