## Overview

Extends the canvas of a source image by N pixels (or a target ratio) on any side. Uses the same outpainting pipeline as the WM Studio Expand tool.

### Auth

oauth-jwt

### Returns

{ job_id, status, image?: { url, width, height } }

### Web client

src/app/[locale]/dashboard/creative-studio/tools/expand-image/expand-image-client.tsx

### MCP handler

mcp-director/src/tools/studio.py

## Quick start

Invoke the tool over Streamable HTTP at `{MCP_BASE_URL}/mcp/`. The request below assumes you already minted an MCP JWT via the OAuth flow.

### MCPcurlTypeScript

```json
{
  "name": "studio_expand_image",
  "arguments": {
    "image_url": "<image_url>"
  }
}
```

## Parameters

| Name                  | Type                                                                            | Default | Description                                           |
|-----------------------|---------------------------------------------------------------------------------|---------|-------------------------------------------------------|
| image_urlrequired     | string                                                                          | —       | Public URL of the source image.                       |
| direction             | "left" \| "right" \| "up" \| "down" \| "all"                        | "all" | Expansion direction.                                   |
| amount_pixels         | number                                                                          | 256     | Pixels to add per selected direction.                 |
| prompt                | string                                                                          | ""     | Optional prompt to guide the new pixels.              |

## Examples

### Expand to 16:9

```json
{
  "name": "studio_expand_image",
  "arguments": {
    "image_url": "https://cdn.wm.studio/uploads/portrait.jpg",
    "direction": "all",
    "amount_pixels": 384
  }
}
```