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

{
  "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

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