# Dreamstudio — how to use (mcp.ai)

Connect your Dreamstudio account and use 5 tools for artificial intelligence straight from your AI agent. Connect with your own API key. DreamStudio is Stability AI's user interface for generative AI, allowing users to create and edit generated images.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_dreamstudio?ms=1787295900000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `dreamstudio_generate_image_from_image`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/dreamstudio`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/dreamstudio/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/dreamstudio/generate/image/from/image` — Tool to generate a new image from an initial image and text prompts. Use after you have a reference image and want to transform it via text guidance.
  - body: { seed?: integer, steps?: integer, width?: integer, height?: integer, samples?: integer, cfg_scale?: number, engine_id: string, init_image: string, text_prompts: object[], image_strength?: number, init_image_mode: string, step_schedule_end?: number, step_schedule_start?: number, clip_guidance_preset?: string }
- `POST https://api.mcp.ai/api/dreamstudio/generate/image/from/text` — Generate images from text prompts using Stability AI's text-to-image models. Use when you need to create images from textual descriptions without a reference image. Supports multiple prompts with weig
  - body: { seed?: integer, steps?: integer, width?: integer, height?: integer, sampler?: string, samples?: integer, cfg_scale?: number, engine_id: string, organization?: string, text_prompts: object[], clip_guidance_preset?: string }
- `POST https://api.mcp.ai/api/dreamstudio/list/engines` — List all available DreamStudio/Stability AI engines accessible with your API key. This action retrieves all AI models (engines) you can use for image generation and other tasks. Common engines include
- `POST https://api.mcp.ai/api/dreamstudio/user/account` — Retrieves authenticated user's account information from Stability AI. Returns user ID, email, organization memberships, and profile picture. No parameters required - uses authenticated session.
- `POST https://api.mcp.ai/api/dreamstudio/user/balance` — Retrieves the user's current credit balance from their DreamStudio account. Use this tool to check how many credits are available before generating images or to monitor remaining credits after API ope

## Example prompts
- "What can I do in Dreamstudio?"
- "Show me a summary of my Dreamstudio account"

## More
- Page: https://mcp.ai/dreamstudio
- Agent spec (llms.txt): https://mcp.ai/dreamstudio/llms.txt
- Postman collection: https://mcp.ai/dreamstudio/postman.json