Dreamlayer MCP server
io.github.TheDesignFounder/dreamlayer·v0.4.0-beta.5Generate and edit images, remove backgrounds, upscale, and create sprite sheets through DreamLayer.
0 stars82 downloads/wk
Reviews
Write oneNobody has reviewed Dreamlayer yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Dreamlayer tools (7, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
dreamlayer_balanceUse before paid image work to check available credits for this API key. Returns promotional, purchased, available and credit_usd. Compare the complete rounded quote against available; separately rounded buckets may sum to 0.1 less. Costs no credits and does not buy credits. Resolve authentication or balance errors before generation.
dreamlayer_capabilitiesUse before choosing an image operation or quoting a sprite job. Read supported operations, input limits and sprite_pricing for this API key, including plain_frame_cents for sprites that keep their background. Returns the current API contract; no image input, generation or credits required. Do not use this to create an asset.
dreamlayer_downloadUse when an existing execution completed or a previous download failed. Requires execution_id and an absolute new local path. Saves the finished image or sprite ZIP and returns path/bytes; starts no generation and spends no new credits. Never overwrites. For output_not_ready check status; for local_output_failed repair the path and download the same execution.
dreamlayer_eventsUse to resume running work or a dropped stream without another generation charge. Requires execution_id; pass the last_event_id actually processed. Returns bounded events, status and recovery cursor. If still running or rate-limited, back off before polling again. Do not repeatedly call in a tight loop or submit replacement work.
dreamlayer_executionUse after a timeout, rate limit or uncertain result to read the existing execution's canonical status. Requires execution_id; costs no credits. Returns state and result details, not a newly generated image. If running, wait and resume events; if completed, download. Do not replace an uncertain paid job.
dreamlayer_generateUse when the user needs an original image, raster logo concept, product or marketing visual, an edit, transparent cutout, upscale, or reference-based sprite animation. Starts paid work within the user's authorized scope and budget. Text-to-image needs a prompt; other operations need input_asset_id. Select operation explicitly. Image operations cost one credit; sprite beta accepts 7–100 frames and
dreamlayer_upload_imagewrite actionUse when an edit, background removal, upscale or sprite animation needs a local reference. Requires an absolute path to PNG, JPEG, WebP or supported camera RAW, up to 200 MB. Uploads that file and returns input_asset_id; starts no paid work. Reuse the asset ID for recovery. Not needed for text-to-image. If upload fails, fix the input or retry upload only.
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 17 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Dreamlayer compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 60% of 1,299 Productivity servers
- Tools
- 7
- the typical Productivity server has 7
- Tools that change things
- 14%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 82
- more than 51% of 427 Productivity servers with a package
What its tools let an agent do: 6 read · 1 change
Release history: 3 versions in the registry since 2026-09-23, latest 2026-09-27, typically one every 3 days.
Install Dreamlayer in Claude Code, Cursor or VS Code
Runs npx -y @dreamlayer/mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add dreamlayer -- npx -y @dreamlayer/mcp
What the publisher says
From the Dreamlayer repository's README, as published. We do not edit it. Read it on GitHub
@dreamlayer/mcp
Image generation and editing tools for MCP-compatible AI clients, backed by the DreamLayer Agent API.
Nothing to clone, nothing to build.
Install
Add it to your client. Claude Code:
claude mcp add dreamlayer --env DREAMLAYER_API_KEY=dlr_live_your_key -- npx -y @dreamlayer/mcpCodex:
codex mcp add dreamlayer --env DREAMLAYER_API_KEY=dlr_live_your_key -- npx -y @dreamlayer/mcpCursor, or any other stdio MCP client:
{
"mcpServers": {
"dreamlayer": {
"command": "npx",
"args": ["-y", "@dreamlayer/mcp"],
"env": { "DREAMLAYER_API_KEY": "dlr_live_your_key" }
}
}
}The key must be in the server's own environment. MCP clients spawn this as a subprocess, so a key exported in your shell does not reach it. That is the most common setup failure, and the server exits with an explanation rather than starting up broken.
Get a key at platform.dreamlayer.io. A new account starts at zero credits, and each finished image costs one.
Tools
Operations
Omit operation and DreamLayer reads the prompt, which may come back asking a clarifying question. Name it and that inference is skipped entirely.
upscale doubles each side and finished images are capped at 4096 per side, so the longest side of your input must be 2048 or less. A larger one is refused before it costs a credit.
Behaviour worth knowing
A question is not a failure. An ambiguous prompt returns a question event ending in needsinput. Answer it by calling dreamlayergenerate again with respond and the conversation_id.
Retries are safe if you reuse the key. An idempotency_key is generated for you. Pass the same one back to retry after an uncertain response and the original result replays rather than paying twice.
Long runs are truncated, not lost. A stream over 256 events returns what it has, marks truncated, and gives you the execution_id and last event id to resume from.
Errors are stable and provider-neutral. Error tool results include code, reason, message, retryable, and request_id, matching REST and the CLI. A model should branch on reason and retryable, never message text. The response excludes prompts, local filenames, asset URLs, provider details, credentials, and raw upstream responses.
Requirements
Node.js 22.12 or later.
License
MIT. See LICENSE and NOTICE.
Sprite-sheet beta
Sprite requests accept exactly one of options.animationprompt (1–4000 characters) or an options.action preset (walk, run, idle). Custom prompts can describe characters, creatures, objects, effects or 360° turntables. animationmode is loop or once; presets default to loop, custom prompts to once. For a turntable, request a stationary camera and rotating subject. Broad requests do not guarantee correct motion, unseen details or successful effect transparency.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Dreamlayer: common questions
- Is Dreamlayer MCP server safe?
- Mostly: it is graded B (83/100). Read the Dreamlayer safety report
- How do I install Dreamlayer?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Dreamlayer need an API key?
- Yes. The registry entry asks for
DREAMLAYER_API_KEY. - Is Dreamlayer maintained?
- The last commit was 17 days ago (2026-10-17). The latest release is v0.4.0-beta.5.
- What can I use instead of Dreamlayer?
- Servers from other publishers that do the same job: Nano Banana by Ace Data Cloud MCP server, MCP Server for Excel and Obsidian MCP server.
- How does Dreamlayer compare with other Productivity MCP servers?
- safety score 83/100 (higher than 60% of 1,299 Productivity servers); tools 7 (the typical Productivity server has 7); tools that change things 14% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Dreamlayer
Same job from other publishers: the closest match first, then the best rated.
Nano Banana by Ace Data CloudGenerate and edit Nano Banana images with Ace Data Cloud; retrieve the same task for results.not reviewedEstablishedA- MCP Server for ExcelExcel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windows only.not reviewedEstablishedA
- ObsidianRead, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.not reviewedEstablishedA
- Agent-Native ContentOpen-source Obsidian for MDX - edit local docs with agent assistancenot reviewedEstablishedA
- gflow-cliDrive Google Flow from an agent: Veo video and Imagen image generationnot reviewedEstablishedA