Skip to main content
Glama
Dreamshot MCP Server

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: mcp-image

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • 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
      43 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables users to generate and edit images from MCP-compatible clients, with automatic prompt optimization and quality presets, and supports Gemini, OpenAI GPT Image, and BytePlus Seedream.
      2,138 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants in any MCP client to generate new images or edit existing ones by turning short requests into detailed prompts with configurable quality presets. Supports Gemini, OpenAI GPT Image, and BytePlus Seedream providers, saving results to disk and returning them as MCP resources.
      2,138 npm
      MIT