Mcp Seedream Pro

acedatacloud/seedreammcp

Connects Claude to ByteDance's Seedream image generation models through the AceDataCloud API. Exposes six tools for text-to-image generation, image editing (style transfer, background changes, virtual try-on), task status tracking, and querying available models and resolutions. Supports multiple Seedream versions (v3 through v5) with options for seed control, sequential generation, and streaming delivery. Works via hosted endpoint at seedream.mcp.acedata.cloud with Bearer token auth, or install locally with uvx. You can generate 1K through 4K images from Chinese or English prompts, modify existing images with SeedEdit v3, and track async generation jobs. Useful when you need production-grade AI image generation directly in your MCP workflow without managing model deployment.

GitHub stars: 3
tools: 6
auth: Secret needed
transport: STDIO, HTTP
env var: 1
last updated: Nov 7, 2026

View on GitHub

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

seedream_generate_imageGenerate an AI image from a text prompt using ByteDance's Seedream model. This tool creates high-quality images from text descriptions using ByteDance's Seedream models (powered by Doubao). Supports multiple model versions with different capabilities and quality levels. Use th...10 params

Generate an AI image from a text prompt using ByteDance's Seedream model. This tool creates high-quality images from text descriptions using ByteDance's Seedream models (powered by Doubao). Supports multiple model versions with different capabilities and quality levels. Use th...

Parameters* required

callback_urlstring

Optional webhook URL to receive the result asynchronously. The API will POST the result to this URL when complete. Must be publicly accessible.default:

guidance_scalevalue

Prompt weight — higher values make the result more closely follow the prompt. Range: [1, 10]. Default is 2.5 for doubao-seedream-3-0-t2i. Only works with v3 models.

modelstring

Model to use for generation. 'doubao-seedream-4-5-251128' (v4.5, latest flagship, best quality). 'doubao-seedream-4-0-250828' (v4.0, stable, best value). 'doubao-seedream-3-0-t2i-250415' (v3 text-t...one of

doubao-seedream-4-5-251128 · doubao-seedream-4-0-250828 · doubao-seedream-3-0-t2i-250415 · doubao-seededit-3-0-i2i-250628

default: doubao-seedream-4-0-250828

promptstring

Description of the image to generate. Be descriptive about subject, style, atmosphere, lighting, and composition. Supports both Chinese and English. Example: 'A photorealistic portrait of an astron...

response_formatvalue

Response format for the generated image. 'url' (default) returns a public image URL. 'b64_json' returns base64-encoded image data.

seedvalue

Random seed for reproducible results. Range: [-1, 2147483647]. Default is -1 (random). Only works with v3 models (doubao-seedream-3-0-t2i and doubao-seededit-3-0-i2i).

sequential_image_generationvalue

Generate related images based on input. 'auto' enables it, 'disabled' (default) turns it off. Only supports v4.5 and v4.0 models.

sizevalue

Output image resolution. '1K' (default), '2K', '4K', or 'adaptive'. You can also specify custom dimensions like '1024x1024', '1280x720', etc.

streamvalue

Stream all pictures progressively. Default is false. Only supports v4.5 and v4.0 models.

watermarkvalue

Whether to add an AI-generated watermark. Default is true.

seedream_edit_imageEdit or modify existing images using ByteDance's Seedream/SeedEdit model. This tool modifies existing images based on text instructions. It can change styles, backgrounds, attributes, clothing, and more. Supports single or multiple image inputs. Use this when: - You want to mo...9 params

Edit or modify existing images using ByteDance's Seedream/SeedEdit model. This tool modifies existing images based on text instructions. It can change styles, backgrounds, attributes, clothing, and more. Supports single or multiple image inputs. Use this when: - You want to mo...

Parameters* required

callback_urlstring

Optional webhook URL for async result notification.default:

guidance_scalevalue

Prompt weight — higher values make edits follow the prompt more closely. Range: [1, 10]. Default is 5.5 for doubao-seededit-3-0-i2i. Only works with v3 models.

imagearray

List of image URLs or base64-encoded images to edit. Supports HTTP/HTTPS URLs (publicly accessible) or base64 format (data:image/png;base64,...). Each image must be under 10MB.

modelstring

Model to use for editing. 'doubao-seededit-3-0-i2i-250628' (dedicated editing model, best for image modification). Other models can also be used for editing when images are provided.one of

doubao-seedream-4-5-251128 · doubao-seedream-4-0-250828 · doubao-seedream-3-0-t2i-250415 · doubao-seededit-3-0-i2i-250628

default: doubao-seededit-3-0-i2i-250628

promptstring

Description of the edit to perform on the image(s). Describe what changes you want. Example: 'Change the background to a beach scene', 'Make the person wear a red dress', 'Convert to watercolor pai...

response_formatvalue

Response format. 'url' (default) or 'b64_json'.

seedvalue

Random seed for reproducible edits. Range: [-1, 2147483647]. Default is -1 (random). Only works with v3 models.

sizevalue

Output image resolution. '1K' (default), '2K', '4K', or 'adaptive'.

watermarkvalue

Whether to add an AI-generated watermark. Default is true.

seedream_list_modelsList all available Seedream models with their capabilities and pricing. Use this when: - User asks what models are available - You need to help choose the right model for a task - You want to compare model capabilities Returns: Formatted table of all Seedream models with descr...

List all available Seedream models with their capabilities and pricing. Use this when: - User asks what models are available - You need to help choose the right model for a task - You want to compare model capabilities Returns: Formatted table of all Seedream models with descr...

No parameter schema in public metadata yet.

seedream_list_sizesList all available image sizes and resolution options for Seedream. Use this when: - User asks about available image sizes - You need to help choose the right resolution - You want to understand size options Returns: Formatted list of all size options with descriptions.

List all available image sizes and resolution options for Seedream. Use this when: - User asks about available image sizes - You need to help choose the right resolution - You want to understand size options Returns: Formatted list of all size options with descriptions.

No parameter schema in public metadata yet.

seedream_get_taskQuery the status and result of a Seedream image generation or edit task. Use this to check if a generation/edit is complete and retrieve the resulting image URLs and metadata. Use this when: - You want to check if an image generation has completed - You need to retrieve image...1 params

Query the status and result of a Seedream image generation or edit task. Use this to check if a generation/edit is complete and retrieve the resulting image URLs and metadata. Use this when: - You want to check if an image generation has completed - You need to retrieve image...

Parameters* required

task_idstring

The task ID returned from a generation or edit request. This is the 'task_id' field from any seedream_generate_image or seedream_edit_image tool response.

seedream_get_tasks_batchQuery multiple Seedream image tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling seedream_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of several im...1 params

Query multiple Seedream image tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling seedream_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of several im...

Parameters* required

task_idsarray

List of task IDs to query. Allows querying multiple tasks at once.