Skip to main content
Glama
syh52
by syh52

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PORTNoPort for HTTP server mode, defaults to 3000 (optional).
TRANSPORTNoTransport mode: 'stdio' (default) or 'http' (optional).
ARK_API_KEYYesYour BytePlus ModelArk API key, required for image generation.
FIREBASE_SERVICE_ACCOUNTNoJSON string of Firebase service account credentials (optional).
FIREBASE_SERVICE_ACCOUNT_PATHNoPath to Firebase service account JSON file for Web App sync (optional).
GOOGLE_APPLICATION_CREDENTIALSNoStandard GCP credential file path for Firebase (optional).

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
seedream_generateA

Generate images from a text description using SeeDream 4.5.

⚠️ CLAUDE.AI USERS: This tool WILL TIMEOUT on Claude.ai (takes 30-60 seconds). Use "seedream_submit" instead with mode="text" for Claude.ai compatibility.

This is the primary tool for creating images from scratch. Default: Generates 4 images per prompt using streaming for fast response.

Args:

  • prompt (string, required): Detailed description of the image to generate

  • size (string): '2K' (default), '4K', '4K-9:16' (2304x4096 high-res vertical), or aspect ratios: '1:1', '4:3', '3:4', '16:9', '9:16', '3:2', '2:3', '21:9'

  • watermark (boolean): Add 'AI generated' watermark (default: false)

  • download (boolean): Save to local directory (default: true)

  • download_dir (string): Local save directory (default: ./generated_images)

  • response_format ('markdown' | 'json'): Output format

Returns: Generated image URL(s), local file path(s) if downloaded, and performance timing.

Prompt Best Practices (per official docs):

  • Structure: Subject + Action + Environment

  • For aesthetics add: Style, Color, Lighting, Composition

  • For text in images: use double quotes - 'poster with title "Hello World"'

  • Specify application context: "Design a logo for...", "Create a poster for..."

  • Keep under 600 English words; concise is better than verbose

Examples:

  • "A girl in a lavish dress walking under a parasol along a tree-lined path, in the style of a Monet oil painting"

  • "Design a logo for a gaming company. The logo features a dog playing with a game controller. The company name 'PITBULL' is written on it."

  • "Vibrant close-up editorial portrait, model with piercing gaze, wearing a sculptural hat, rich color blocking, Vogue magazine aesthetic"

  • "A cluttered office desk with an open laptop showing green code, a mug with the word 'Developer' on it, sunlight from the right"

Tips:

  • Be specific: "golden retriever puppy" > "dog"

  • Use natural language, not keyword lists

  • Include style keywords: "oil painting style", "anime art", "photorealistic"

  • Specify composition: "close-up portrait", "bird's eye view", "cinematic wide shot"

seedream_editA

Edit an existing image based on text instructions using SeeDream 4.5.

⚠️ CLAUDE.AI USERS: This tool WILL TIMEOUT on Claude.ai (takes 20-40 seconds). Use "seedream_submit" instead with mode="image" for Claude.ai compatibility.

Use this tool to modify, enhance, or transform an existing image. Supports:

  • Addition: Add elements (accessories, objects, background elements)

  • Deletion: Remove unwanted elements

  • Replacement: Swap one element for another

  • Modification: Change colors, styles, lighting, expressions

  • Style transfer: Apply artistic styles to photos

Args:

  • prompt (string, required): Edit instruction describing the changes

  • image (string, required): Source image URL or local file path

  • size (string): Output size (default: '2K')

  • strength (number): Reference strength 0-1 (default: 0.7)

  • watermark (boolean): Add watermark (default: false)

  • download (boolean): Save locally (default: true)

  • download_dir (string): Local save directory

Returns: Edited image URL, local path if downloaded, and performance timing.

Edit Instruction Best Practices (per official docs):

  • Use concise, unambiguous instructions

  • Be specific: "the person's shirt" not "it"

  • Specify what should remain unchanged: "keeping the pose unchanged"

  • For targeted edits: draw arrows/boxes on image and reference them Example: "Insert a TV where the red area is marked"

Supported Operations:

  • Addition: "Add matching silver earrings and a necklace to the girl"

  • Deletion: "Remove the girl's hat"

  • Replacement: "Replace the largest bread man with a croissant man"

  • Modification: "Turn the robots into transparent crystal, colored red, yellow and green"

Examples:

  • "Add sunglasses to the person, keeping everything else unchanged"

  • "Change the background to a beach sunset"

  • "Apply Van Gogh oil painting style to this photo"

  • "Remove the text from the image"

  • "Dress the tallest panda in pink Peking Opera costume, keeping its pose unchanged"

seedream_blendA

Combine elements from multiple images using SeeDream 4.5.

⚠️ CLAUDE.AI USERS: This tool WILL TIMEOUT on Claude.ai (takes 30-60 seconds). Use "seedream_submit" instead with mode="multi" for Claude.ai compatibility.

Use this tool to blend 2-14 reference images together. Perfect for:

  • Virtual try-on: Dress person from image 1 in clothes from image 2

  • Face/Subject swap: Put face/subject from image 1 onto body/scene in image 2

  • Style transfer: Apply style of image 2 to content of image 1

  • Product visualization: Put product from image 1 into scene from image 2

  • Character consistency: Combine character traits from multiple references

Args:

  • prompt (string, required): Blending instruction referencing images by number

  • images (string[], required): Array of 2-14 image URLs or local paths

  • size (string): Output size (default: '2K')

  • strength (number): Reference strength 0-1 (default: 0.7)

  • watermark (boolean): Add watermark (default: false)

  • download (boolean): Save locally (default: true)

  • download_dir (string): Local save directory

Returns: Blended image URL, local path if downloaded, and performance timing.

Prompt Structure (per official docs):

  • Reference Target: Clearly specify what to extract from each reference image

  • Scene Description: Describe the output scene layout and composition

  • Always reference images by number: "image 1", "image 2", etc.

Common Use Cases:

  • Virtual try-on: "Dress the character in Image 1 with the outfit from Image 2"

  • Subject replacement: "Replace the subject in Image 1 with the subject from Image 2"

  • Style transfer: "Apply the style of Image 2 to Image 1"

  • Product placement: "Place the product from Image 1 on the table in Image 2"

Examples:

  • "Replace the clothing in image 1 with the outfit from image 2"

  • "Put the face from image 1 onto the body in image 2, maintaining natural lighting"

  • "Apply the linear minimalist style of image 2 to design icons based on image 1"

  • "Generate four tops in different materials, based on the clothing style worn by the girl in the reference images"

Tips:

  • Be specific about which elements to take from each image

  • For best results, use similar aspect ratios for inputs

  • Higher strength preserves more details from reference images

  • Using 10+ reference images significantly impacts generation speed

seedream_variationsA

Generate multiple variations of an image concept using SeeDream 4.5.

⚠️ CLAUDE.AI USERS: This tool WILL TIMEOUT on Claude.ai (takes 30-90 seconds). Use "seedream_submit" instead for Claude.ai compatibility.

Use this tool to create 2-15 coherent variations based on a prompt. Great for:

  • A/B testing: Generate multiple options to compare

  • Storyboards: Create a series of related images

  • Product variations: Same product in different colors/styles

  • Exploration: See different interpretations of your concept

  • Social media: Multiple posts from one concept

Args:

  • prompt (string, required): Base concept for generating variations. Include batch keywords like "a series", "a set", "Generate X images" for best results.

  • count (number): Number of variations to generate (2-15, default: 4)

  • base_image (string, optional): Reference image to create variations from

  • size (string): Output size (default: '2K')

  • watermark (boolean): Add watermark (default: false)

  • download (boolean): Save locally (default: true)

  • download_dir (string): Local save directory

Returns: Array of variation image URLs, local paths if downloaded, and performance timing.

Prompt Best Practices (per official docs):

  • Include batch keywords: "a series of", "a set of", "Generate X images"

  • Describe variations explicitly: "4 seasonal versions", "different color schemes"

  • For storyboards: describe each panel's content in sequence

  • Keep prompts under 600 English words for best results

Examples:

  • "Generate a series of 4 seasonal variations of a cozy coffee shop interior"

  • "Create a set of 6 color variations of this minimalist logo design"

  • "Generate 4 different poses of this anime character in action"

  • "Create a 4-panel storyboard: morning coffee, commute, work, evening relaxation"

Tips:

  • The model maintains consistency across variations automatically

  • Use count=4 for quick comparisons, higher for more options

  • Adding a base_image helps maintain visual consistency

  • Note: base_image cannot be combined with batch generation (API limitation)

seedream_statusA

Check the health and status of the SeeDream MCP server.

Use this tool to verify the server is working correctly before generating images. This does NOT consume API quota - it's a free diagnostic check.

Args:

  • verbose (boolean): Include detailed system info (default: false)

Returns: Server health status, configuration check, and available tools.

Use when:

  • First connecting to verify everything is set up correctly

  • Troubleshooting when image generation fails

  • Checking if API key is configured properly

seedream_submitA

Submit an image generation task. Returns immediately - images will appear in the Web App.

USE THIS TOOL ON CLAUDE.AI - The regular seedream_generate tool times out on Claude.ai. This tool returns immediately after submitting the task.

After submitting: View your generated images at https://seedream-gallery.firebaseapp.com

Args:

  • prompt (string, required): Description of the image to generate

  • mode (string): 'text' (default), 'image' (editing with 1 ref image), or 'multi' (blending 2+ images)

  • size (string): '2K' (default), '4K', '4K-9:16' (2304x4096), or aspect ratios: '1:1', '4:3', '3:4', '16:9', '9:16', '3:2', '2:3', '21:9'

  • count (number): Number of images to generate (1-15, default: 4)

  • strength (number): Reference strength 0-1 for image/multi modes (default: 0.7)

  • images (string[]): Reference image URLs for 'image' or 'multi' modes

Examples:

  • Text mode: { prompt: "A sunset over mountains", mode: "text" }

  • Image mode: { prompt: "Make this photo look like an oil painting", mode: "image", images: ["https://...jpg"] }

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.3/5.0

Scored across 6 tools

Disambiguation3/5

The core image tools are mostly distinguishable: generate creates from text, edit modifies a single image, blend combines multiple images, and variations makes coherent batches. However, seedream_submit duplicates generate/edit/blend behavior with only async execution as the differentiator, which creates real ambiguity about which tool an agent should select.

Naming Consistency4/5

All tools share the consistent seedream_ prefix and mostly use verb-style suffixes (edit, generate, blend, submit). variations and status are noun suffixes, which is a minor deviation, but the overall pattern remains predictable and readable.

Tool Count4/5

Six tools is a reasonable size for an image generation server, and most tools serve a distinct purpose. However, seedream_submit largely overlaps with the other image tools and exists primarily as a compatibility workaround, making the set feel slightly padded.

Completeness4/5

The server covers the main image workflows well: generation, editing, blending, variations, and health checking. The notable gap is that seedream_submit offers no MCP-based way to poll for results or retrieve submitted task outputs programmatically, forcing users to check an external web app.

Maintenance

ActivityInactive
ResponsivenessNo issues