generate_image
Generate Image. Generate one image, or edit one, and get back its url.
| Group | Access | MCP name |
|---|---|---|
| Notes | Writes data | generate_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
| 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
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.
| Field | Type | Required | Description |
|---|---|---|---|
mediaType | string | Yes | |
size | string | Yes | |
url | string | Yes |
Annotations
| Hint | Value |
|---|---|
readOnlyHint | false |
destructiveHint | false |
openWorldHint | true |
The full input and output JSON Schemas for every tool are in /mcp-tools.json.
update_note
Update Note. Update an existing note's content, status, tags, auto-restack delay (autoRestackAfterHours), Buffer cross-post channels (bufferChannelIds), per-channel Buffer posts (bufferChannelPosts), or link preview (includePreviews).
generate_gif
Generate GIF. Generate one animated GIF and get back its url.