Skip to main content
Glama
Dreamshot-io

Dreamshot MCP Server

by Dreamshot-io

Dreamshot MCP Server

npm version License: MIT

MCP server for Dreamshot AI image and video generation. Use it with Claude Desktop, Claude Code, or any MCP-compatible client.

Quick Start

1. Get your API key

Sign up at dreamshot.io and get your API key from Settings > API.

2. Add to your MCP config

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "dreamshot": {
      "command": "npx",
      "args": ["@dreamshot/mcp-server"],
      "env": {
        "DREAMSHOT_API_KEY": "dst_your_key_here"
      }
    }
  }
}

Claude Code (.mcp.json):

{
  "mcpServers": {
    "dreamshot": {
      "command": "npx",
      "args": ["@dreamshot/mcp-server"],
      "env": {
        "DREAMSHOT_API_KEY": "dst_your_key_here"
      }
    }
  }
}

3. Start using it

Ask Claude to generate images or videos:

"Generate a product photo on a marble surface" "Create a 5-second video panning around this product" "Upscale this image to 4K"

Related MCP server: @genoooool/mcp-image-generator

Available Tools

Tool

Description

dreamshot_list_tools

List available tools with variants and credit costs

dreamshot_generate

Start an AI generation (returns generationId)

dreamshot_status

Check generation status (pending/completed/failed)

dreamshot_media

Get download URLs for completed generations

dreamshot_credits

Check remaining credits

Supported AI Tools

Image Editing (ai_edit)

Edit images using AI with text prompts.

Variant

Credits

Description

ultra

1

Best quality, supports model references

nano

0.5

Fast iterations

seedream

0.5

Seedream model

flux

0.5

FLUX-based editing

flux2max

1

FLUX 2 Max quality

gpt_image_1

1.5

OpenAI GPT Image

Video Generation (create_video)

Generate videos from images and/or text prompts.

Model

Credits

Description

google/veo-3.1

16+

Latest Veo with audio

kwaivgi/kling-v2.6

4-14

Kling 2.6 Pro

fal-ai/kling-v3-pro

17

Kling 3.0 Pro

openai/sora-2

4-12

OpenAI Sora 2

openai/sora-2-pro

8-24

OpenAI Sora 2 Pro

Image Enhancement (enhancer)

Upscale and enhance image quality.

Variant

Credits

Description

dreamshot

2

General upscaling

magnific_precision

3

Sharp, detailed

magnific_creative

4

Creative enhancement

More Tools

  • generate_image - Generate from trained models

  • create_anything - Text-to-image with FLUX

Run dreamshot_list_tools to see all available tools and current pricing.

Example Workflow

1. Check credits
   → dreamshot_credits()

2. Start generation
   → dreamshot_generate(
       tool: "ai_edit",
       variant: "ultra",
       prompt: "luxury perfume on marble",
       imageUrls: ["https://..."]
     )
   → Returns: { generationId: "abc123" }

3. Poll status
   → dreamshot_status(generationId: "abc123")
   → Returns: { status: "pending" }

4. Poll again
   → dreamshot_status(generationId: "abc123")
   → Returns: { status: "completed", mediaItems: [...] }

5. Get download URLs
   → dreamshot_media(generationId: "abc123")
   → Returns: { media: [{ downloadUrl: "..." }] }

Environment Variables

Variable

Required

Description

DREAMSHOT_API_KEY

Yes

Your Dreamshot API key (dst_xxx)

DREAMSHOT_BASE_URL

No

Custom API URL (defaults to https://app.dreamshot.io/api/v1)

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Run built version
npm start

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Enables image generation and multi-turn editing sessions using the Gemini API within MCP-compatible environments. Users can create, modify, and configure images through natural language commands, supporting features like aspect ratio adjustments and session-based image transformations.
    5
    ISC
  • A
    license
    A
    quality
    B
    maintenance
    Image tools for coding agents: generate from text, edit one reference image, remove backgrounds, upscale 2x, and create reference-based sprite animations. The MCP server, CLI and REST API share one key, credit balance and request history. Needs a DreamLayer API key and paid credits; sprite sheets are beta.
    7
    50 npm
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables users to generate and edit images from MCP-compatible clients by automatically enhancing prompts with details like composition, lighting, and camera angle before sending them to Gemini, OpenAI, or BytePlus Seedream. Supports quality presets, multiple providers, and saving generated images to disk.
    932 npm
    MIT