seedream_list_models

Instructions

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 descriptions.

Implementation Reference

• tools/info_tools.py:6-69 (handler)

  Core handler function for the seedream_list_models tool. Defined as an async function decorated with @mcp.tool(). Returns a formatted markdown string listing all available Seedream models (doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415, doubao-seededit-3-0-i2i-250628) with their versions, types, features, pricing, and a model selection guide.

  @mcp.tool()
  async def seedream_list_models() -> str:
      """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 descriptions.
      """
      # Last updated: 2026-04-05
      return """# Available Seedream Models
  
  | Model | Version | Type | Features | Price |
  |-------|---------|------|----------|-------|
  | `doubao-seedream-5-0-260128` | v5.0 | Text-to-Image | Latest flagship, highest quality, sequential generation, streaming, web search | ~$0.040/image |
  | `doubao-seedream-4-5-251128` | v4.5 | Text-to-Image | Previous flagship, great quality, sequential generation, streaming | ~$0.037/image |
  | `doubao-seedream-4-0-250828` | v4.0 | Text-to-Image | Stable, cost-effective, sequential generation, streaming | ~$0.030/image |
  | `doubao-seedream-3-0-t2i-250415` | v3.0 | Text-to-Image | Seed control, guidance scale, reproducible results | ~$0.038/image |
  | `doubao-seededit-3-0-i2i-250628` | v3.0 | Image-to-Image | Image editing, style transfer, seed control, guidance scale | ~$0.046/image |
  
  ## Model Selection Guide
  
  ### For Best Quality
  → **doubao-seedream-5-0-260128** (v5.0)
  - Latest flagship model with highest quality
  - Best for professional/commercial use
  
  ### For Previous Flagship Quality
  → **doubao-seedream-4-5-251128** (v4.5)
  - Great quality and detail
  - Good for professional use
  
  ### For Best Value
  → **doubao-seedream-4-0-250828** (v4.0)
  - Great balance of quality and cost
  - Recommended for most use cases
  
  ### For Reproducible Results
  → **doubao-seedream-3-0-t2i-250415** (v3.0 T2I)
  - Supports seed parameter for exact reproducibility
  - Supports guidance_scale for fine-tuning prompt adherence
  
  ### For Image Editing
  → **doubao-seededit-3-0-i2i-250628** (v3.0 I2I)
  - Dedicated editing model
  - Requires input image(s)
  - Best for style transfer, background changes, virtual try-on
  
  ## Feature Comparison
  
  | Feature | v5.0 | v4.5 | v4.0 | v3.0 T2I | v3.0 I2I (Edit) |
  |---------|------|------|------|----------|-----------------|
  | Text-to-Image | ✅ | ✅ | ✅ | ✅ | ❌ |
  | Image Editing | ❌ | ❌ | ❌ | ❌ | ✅ |
  | Seed Control | ❌ | ❌ | ❌ | ✅ | ✅ |
  | Guidance Scale | ❌ | ❌ | ❌ | ✅ (default 2.5) | ✅ (default 5.5) |
  | Sequential Gen | ✅ | ✅ | ✅ | ❌ | ❌ |
  | Streaming | ✅ | ✅ | ✅ | ❌ | ❌ |
  | Web Search | ✅ | ❌ | ❌ | ❌ | ❌ |
  | Resolution | 1K/2K/3K/4K/Adaptive | 1K/2K/3K/4K/Adaptive | 1K/2K/3K/4K/Adaptive | 1K/2K/3K/4K/Adaptive | 1K/2K/3K/4K/Adaptive |
  """

• main.py:48-52 (registration)

  Tool registration via @mcp.tool() decorator on the async function in tools/info_tools.py. The server card JSON (lines 160-198) also lists it as one of the available tools under 'seedream_list_models'.

  def main() -> None:
      """Run the MCP Seedream server."""
      parser = argparse.ArgumentParser(

• tools/info_tools.py:6-8 (schema)

  The tool has no input parameters (no schema for inputs). It takes no arguments and returns a plain string.

  @mcp.tool()
  async def seedream_list_models() -> str:
      """List all available Seedream models with their capabilities and pricing.

• tools/__init__.py:1-10 (helper)

  Tools module __init__.py imports info_tools, which triggers the @mcp.tool() decorator registration when the module is loaded.

  """Tools module for MCP Seedream server."""
  
  # Import all tools to register them with the MCP server
  from tools import image_tools, info_tools, task_tools
  
  __all__ = [
      "image_tools",
      "task_tools",
      "info_tools",
  ]

• tests/test_integration.py:55-70 (helper)

  Integration test that imports and calls seedream_list_models(), asserting that specific model names (doubao-seedream-4-0-250828 and doubao-seedream-4-5-251128) appear in the result.

  class TestInfoTools:
      """Integration tests for informational tools."""
  
      @pytest.mark.asyncio
      async def test_list_models(self) -> None:
          """Test seedream_list_models tool."""
          from tools.info_tools import seedream_list_models
  
          result = await seedream_list_models()
  
          print("\n=== List Models Result ===")
          print(result)
  
          assert "doubao-seedream-4-0-250828" in result
          assert "doubao-seedream-4-5-251128" in result