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

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

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

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

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

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

## 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).
