Tool reference

generate_gif

Generate GIF. Generate one animated GIF and get back its url.

GroupAccessMCP name
NotesWrites datagenerate_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

ArgumentTypeRequiredDescription
aspectstringNosquare for notes and most posts. portrait for phone-first posts. landscape for article headers. One of: "square", "portrait", "landscape". Default "square".
backgroundstringNoopaque 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".
frameDurationMsintegerNoHow 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.
framesintegerNoHow 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.
promptstringYesWhat 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.
qualitystringNolow 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.

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