MCP Tools

Media Tools

1 MCP tool for AI image generation. Generate images for article hero and inline media blocks using FLUX 1.1 Pro.

Images are generated using FLUX 1.1 Pro via Replicate and stored in Supabase Storage. Only works with media blocks (B-40 Hero Image or B-14 Inline Image).

aeo_generate_image

Generate an AI image for a media block using FLUX 1.1 Pro. Automatically determines dimensions based on block type (hero vs inline) unless overridden. Optionally accepts a reference image to guide style and composition.

Parameters

Name	Type	Required	Description
`execution_id`	string	Required	Pipeline execution ID the media block belongs to
`instance_id`	string	Required	Media block instance ID (B-40 Hero Image or B-14 Inline Image)
`prompt_override`	string	Optional	Custom prompt instead of the block's default prompt
`width`	number	Optional	Image width in pixelsDefault: `1200 (hero) / 800 (inline)`
`height`	number	Optional	Image height in pixelsDefault: `630 (hero) / 450 (inline)`
`reference_image_url`	string	Optional	URL of a reference image to guide style and composition
`reference_strength`	number	Optional	How strongly to follow the reference image (0 to 1)Default: `0.1`
`raw`	boolean	Optional	Skip the photorealistic prefix and use the prompt as-is

Hero Image Example

json

class=class="code-string">"code-comment">// Agent calls:
aeo_generate_image({
  execution_id: class="code-string">"exec-a1b2c3d4",
  instance_id: class="code-string">"blk-hero-001",
  prompt_override: class="code-string">"Professional healthcare team reviewing patient data on a tablet in a modern clinic, warm lighting, editorial photography style",
  width: 1200,
  height: 630
})

Response

json

{
  class="code-string">"message": class="code-string">"Image generated and stored for block blk-hero-001",
  class="code-string">"instance_id": class="code-string">"blk-hero-001",
  class="code-string">"image_url": class="code-string">"https:class="code-commentclass="code-string">">//txjgfecvqacqcfekxmdn.supabase.co/storage/v1/object/public/article-images/exec-a1b2c3d4/blk-hero-001.webp"
}

Using Reference Images

Pass a reference_image_url to guide the generated image toward a specific style, brand palette, or composition. The reference_strength parameter controls the balance between creative freedom and fidelity to the reference - lower values give more creative latitude.

Inline Image with Reference

json

class=class="code-string">"code-comment">// Agent calls:
aeo_generate_image({
  execution_id: class="code-string">"exec-a1b2c3d4",
  instance_id: class="code-string">"blk-inline-003",
  reference_image_url: class="code-string">"https:class="code-commentclass="code-string">">//example.com/brand-photo.jpg",
  reference_strength: 0.3
})

Response

json

{
  class="code-string">"message": class="code-string">"Image generated and stored for block blk-inline-003",
  class="code-string">"instance_id": class="code-string">"blk-inline-003",
  class="code-string">"image_url": class="code-string">"https:class="code-commentclass="code-string">">//txjgfecvqacqcfekxmdn.supabase.co/storage/v1/object/public/article-images/exec-a1b2c3d4/blk-inline-003.webp"
}

aeo_generate_image

Parameters

Name	Type	Required	Description
`execution_id`	string	Required	Pipeline execution ID the media block belongs to
`instance_id`	string	Required	Media block instance ID (B-40 Hero Image or B-14 Inline Image)
`prompt_override`	string	Optional	Custom prompt instead of the block's default prompt
`width`	number	Optional	Image width in pixelsDefault: `1200 (hero) / 800 (inline)`
`height`	number	Optional	Image height in pixelsDefault: `630 (hero) / 450 (inline)`
`reference_image_url`	string	Optional	URL of a reference image to guide style and composition
`reference_strength`	number	Optional	How strongly to follow the reference image (0 to 1)Default: `0.1`
`raw`	boolean	Optional	Skip the photorealistic prefix and use the prompt as-is

Hero Image Example

json

class=class="code-string">"code-comment">// Agent calls:
aeo_generate_image({
  execution_id: class="code-string">"exec-a1b2c3d4",
  instance_id: class="code-string">"blk-hero-001",
  prompt_override: class="code-string">"Professional healthcare team reviewing patient data on a tablet in a modern clinic, warm lighting, editorial photography style",
  width: 1200,
  height: 630
})

Response

json

{
  class="code-string">"message": class="code-string">"Image generated and stored for block blk-hero-001",
  class="code-string">"instance_id": class="code-string">"blk-hero-001",
  class="code-string">"image_url": class="code-string">"https:class="code-commentclass="code-string">">//txjgfecvqacqcfekxmdn.supabase.co/storage/v1/object/public/article-images/exec-a1b2c3d4/blk-hero-001.webp"
}

Using Reference Images

Inline Image with Reference

json

class=class="code-string">"code-comment">// Agent calls:
aeo_generate_image({
  execution_id: class="code-string">"exec-a1b2c3d4",
  instance_id: class="code-string">"blk-inline-003",
  reference_image_url: class="code-string">"https:class="code-commentclass="code-string">">//example.com/brand-photo.jpg",
  reference_strength: 0.3
})

Response

json

{
  class="code-string">"message": class="code-string">"Image generated and stored for block blk-inline-003",
  class="code-string">"instance_id": class="code-string">"blk-inline-003",
  class="code-string">"image_url": class="code-string">"https:class="code-commentclass="code-string">">//txjgfecvqacqcfekxmdn.supabase.co/storage/v1/object/public/article-images/exec-a1b2c3d4/blk-inline-003.webp"
}