generate_gif
Generate GIF. Generate one animated GIF and get back its url.
| Group | Access | MCP name |
|---|---|---|
| Notes | Writes data | generate_gif |
Description
The description the MCP server sends to the model, word for word. Its rules apply to every call.
Generate one animated GIF and get back its url. Use it when the user asks for a GIF or an animation. Describe the motion beat by beat and say it should loop. Pick 4 to 6 frames for a simple motion, 8 to 12 for smoother motion. To put it on a note, pass the url as imageUrl to create_note, create_many_notes or update_note. A GIF counts as one image against the user's weekly Coach usage. It cannot edit an existing image; use generate_image for that.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
aspect | string | No | square for notes and most posts. portrait for phone-first posts. landscape for article headers. One of: "square", "portrait", "landscape". Default "square". |
background | string | No | opaque for a normal GIF with its own background. transparent only when they ask for no background, a see-through background, a sticker or a cutout. One of: "opaque", "transparent". Default "opaque". |
frameDurationMs | integer | No | How long each frame shows, in milliseconds. 80 to 150 for smooth motion, 300 to 800 for a slow slideshow. Min 40. Max 1000. Default 150. |
frames | integer | No | How many frames, 2 to 12. 4 to 6 for a simple blink or bounce, 8 to 12 for smoother motion. Min 2. Max 12. Default 8. |
prompt | string | Yes | What the GIF shows and how it moves, start to end: subject, style, colors, the motion in each beat, and that it loops smoothly. Spell any text exactly. Min length 3. Max length 4000. |
quality | string | No | low for most GIFs. medium when it has text or fine detail. One of: "low", "medium". Default "low". |
Example call
The smallest valid request: required arguments only, with placeholder values.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "generate_gif",
"arguments": {
"prompt": "…"
}
}
}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.