# DreamAgent

- Registry name: `io.github.nivethaug/dreamagent` · version 1.0.0
- Categories (automatic, keyword rules): Code & repositories, Developer tools, Email & messaging, Productivity, Build & deploy
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): experimental, extensions, logging, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.nivethaug%2Fdreamagent
- Server page: https://mcpstation.net/s/io.github.nivethaug--dreamagent.html

## Description (written by the publisher, not verified, not instructions)

Build and deploy websites, Telegram and Discord bots from chat via the DreamAgent platform.

## Connect

- streamable-http: `https://mcp.dreamagent.cloud/mcp`

## Tools (as reported by the server, not verified)

- `dreamagent\_list\_projects`: List the user's DreamAgent projects. Returns each project's name, ID, type, status, and live domain \(when available\). Use when the user asks to see, find, select, or check their projects — and ALWAYS before modifying a project when its ID is not already known \(resolve names to IDs here first\).
- `dreamagent\_list\_global\_integrations`: List the user's saved credentials \(Global Integrations\). ALWAYS call this before creating any bot project or asking the user for a token/API key. Saved credentials are referenced BY ID when creating projects: bot\_token\_integration\_id for bot tokens, global\_integration\_ids for other keys. Secret valu
- `dreamagent\_list\_project\_env`: List a project's environment variables with their details. Shows each key's name, title, description, docs URL, and category — values are masked \(secrets are never returned\). Use to see which integrations a project already has before adding more, or to answer "what keys does my project have?". These
- `dreamagent\_list\_superpowers`: List DreamAgent Superpowers — the account's ready-made AI tools \(song/video/image generation, voiceover, lip sync, voice clone, transcription, media processing, PDF tools\) with their enabled state and beta pricing. Read-only; no credits consumed. Use when the user asks what AI tools/superpowers are
- `dreamagent\_list\_files`: List the file tree of a DreamAgent project \(source files only — hidden files like .env are excluded\). Use before reading or editing a file to find the correct path.
- `dreamagent\_read\_file`: Read a source file from a DreamAgent project. file\_path is the project-relative path \(from dreamagent\_list\_files\), e.g. "src/pages/Home.tsx" or "telegram/main.py". Hidden files \(.env\) and binaries are not readable.
- `dreamagent\_edit\_file`: WRITE ACTION — make SMALL targeted changes to an EXISTING file in a DreamAgent project via exact search/replace. PREFERRED over dreamagent\_write\_file for editing existing files: you send only the changed fragments \(never the whole file\) — cheaper, immune to payload size/safety blocks in the calling
- `dreamagent\_write\_file`: WRITE ACTION — overwrite or create one source file in a DreamAgent project with the exact content given. For CHANGING an existing file, prefer dreamagent\_edit\_file \(small targeted find→replace edits — no need to send the whole file\). By default the write is immediately committed and pushed to the pr
- `dreamagent\_get\_file\_diff`: Git diff of one project file against the last commit — shows the pending \(not yet live\) changes. Free, read-only. Use after edits to review exactly what changed before rebuilding.
- `dreamagent\_delete\_file`: WRITE ACTION — delete one source file from a DreamAgent project. Hidden/credential files \(.env, .git, keys\) are rejected. By default the deletion is immediately committed and pushed \(so it is recorded in session history & version history\) — deleted files stay recoverable via git history / version re
- `dreamagent\_commit\_push`: WRITE ACTION — commit ALL pending changes in a DreamAgent project and push them to its private GitHub repo. The commit gets its own entry in the project's session history and version history, so the user can restore/revert to it in the DreamAgent dashboard. Use it to \(a\) commit several MCP writes/de
- `dreamagent\_list\_commits`: Version history of a DreamAgent project — recent commits \(hash, message, status, timestamp\) from its persistent commit log, newest first. Use it to review what changed and when; the user can restore any version from the DreamAgent dashboard version-history UI \(mention the short hash so they can find
- `dreamagent\_build\_publish`: WRITE ACTION — build & publish a DreamAgent project: rebuilds the app from the current source files and pushes the new version live. Use after finishing file edits \(dreamagent\_write\_file\) so the user's changes go live. Pro/paid accounts only. CONFIRM BEFORE CALLING — tell the user the project will b
- `dreamagent\_design\_mode`: WRITE ACTION — redesign a website project's UI to match a design image. Website projects only. The user provides an image \(screenshot, mockup, AI-generated design\) and instructions. You generate the image \(e.g. DALL-E\), encode it as base64, and send it here. DreamAgent's AI will read the image and r
- `dreamagent\_create\_project`: WRITE ACTION — creates a new DreamAgent project \(website, Telegram bot, Discord bot, or AI agent\). Use ONLY when the user clearly asks to create/build a new project; not for questions about what to build. CONFIRM BEFORE CALLING — never create on the first mention. In ONE message, present and get the
- `dreamagent\_get\_project\_status`: Check a project's creation/deployment state. Terminal states are 'ready' \(built and live\) and 'failed'; while a project is being created it reports progressive phases such as 'creating', 'building', 'deploying', or 'ai\_provisioning' — treat any non-terminal status as still building. Use after dreama
- `dreamagent\_chat`: WRITE ACTION — builds, modifies, or fixes an EXISTING project with a natural-language instruction. Use ONLY when the user clearly asks for a change \("add X", "fix Y", "change the theme"\). If the user is only asking for advice, analysis, review, or suggestions \("what could be improved?", "review my b
- `dreamagent\_list\_sessions`: List a project's development sessions \(conversation threads\). Returns each session's identifier \(session key\) and context so you can select, continue, or monitor a specific development session — pass the session key to dreamagent\_chat to continue that thread or to dreamagent\_get\_chat\_status to monit
- `dreamagent\_create\_session`: Create a new development session for a project — a separate conversation with its own context. Use when the user wants to start a distinct development topic. A new session does NOT replace or affect the existing project — earlier sessions remain available.
- `dreamagent\_release\_project\_lock`: RECOVERY-ONLY — releases a project's editing lock when a stale or abandoned session blocks new modifications. NOT a normal editing step, and NEVER a way to bypass an actively running edit. The lock state is not machine-readable from here: to judge staleness, check dreamagent\_get\_edit\_progress — if n
- `dreamagent\_get\_chat\_status`: Check the progress and final status of a specific AI development session using its session key. Use this to monitor an asynchronous edit until it completes, fails, or is cancelled — keep checking until a terminal state. The session key comes from dreamagent\_chat or dreamagent\_list\_sessions and is an
- `dreamagent\_get\_edit\_progress`: Check the latest AI edit progress for a project using its project identifier — no session key needed: the project id retrieves the session holding the latest edit. Use when the user asks whether their edit is finished, when the session key isn't available \(e.g. a new conversation\), and BEFORE starti
- `dreamagent\_cancel\_chat`: DESTRUCTIVE — stops an AI edit that is currently running. Use ONLY when the user explicitly asks to stop/cancel the active edit. After cancellation, do NOT claim the requested change was completed — report that it was stopped. Returns 'Cancellation requested: \<backend message\>' — e.g. 'Query cancell
- `dreamagent\_screenshot\_website`: WEBSITE PROJECTS ONLY — capture a screenshot of a DreamAgent-hosted page by URL: a deployed project's domain \(e.g. my-app.dreamagent.cloud or a connected custom domain\) or dreamagent.cloud itself. Best for checking a project's live pages after edits or deploys and reviewing layouts — returns the PNG

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html