Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

DreamAgent

von nivethaugVersion 1.0.0i★ 0iLäuft in der Cloud
Name in der Registryio.github.nivethaug/dreamagent

So installierst du es

Überblick

Beschreibung vom Entwickler (englisches Original)

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

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

  • Verbindung: Läuft in der Cloud
  • Transport: Streamable HTTP
  • Kategorie: Chat & E-Mail

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

3/4 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.dreamagent.cloud)

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1+ Add2https://…3Add4
  2. Klicke „+ Add“ → „Add custom connector“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameDreamAgent
    Remote MCP server URL · Adressehttps://mcp.dreamagent.cloud/mcp

    Authentication so lassen, wie Claude es erkannt hat, dann Add klicken

  3. Im Chat einschalten

    +ConnectorsDreamAgent

  4. Ausprobieren

    Nutze DreamAgent und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es DreamAgent nutzt, oder ein Werkzeug von DreamAgent in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT nur in Firmen-Tarifen

ChatGPT Business, Enterprise oder Edu im Web, hinzugefügt von Admin oder Inhaber des Workspace · Mit Free, Plus oder Pro: Dein ChatGPT-Tarif kann MCP noch nicht selbst verbinden

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameDreamAgent
    Connection · Adressehttps://mcp.dreamagent.cloud/mcp
  3. DreamAgent im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen DreamAgent aus deinen Plugins wählen

  4. Ausprobieren

    Nutze DreamAgent und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es DreamAgent nutzt, oder ein Werkzeug von DreamAgent in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http dreamagent https://mcp.dreamagent.cloud/mcp
  3. /mcp in Claude Code eingeben

    DreamAgent sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze DreamAgent und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es DreamAgent nutzt, oder ein Werkzeug von DreamAgent in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze DreamAgent und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es DreamAgent nutzt, oder ein Werkzeug von DreamAgent in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze DreamAgent und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es DreamAgent nutzt, oder ein Werkzeug von DreamAgent in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.dreamagent.cloud/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die DreamAgent nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http dreamagent https://mcp.dreamagent.cloud/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "dreamagent": {
      "url": "https://mcp.dreamagent.cloud/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "dreamagent": {
      "type": "http",
      "url": "https://mcp.dreamagent.cloud/mcp"
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Lizenzi
Keine Lizenz angegeben
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.0.0
In der Registry veröffentlichti
15. Aug. 2026
Code zuletzt geänderti
22. Okt. 2026
Entwickler
nivethaug
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 11. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • 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 ID

  • 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 oth

  • 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 p

  • 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 to

  • dreamagent_list_files Sieht aus wie eine Anweisung an die KI

    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 Sieht aus wie eine Anweisung an die KI

    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 bl

  • dreamagent_write_file Sieht aus wie eine Anweisung an die KI

    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

  • 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 Sieht aus wie eine Anweisung an die KI

    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

  • 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 s

  • 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 h

  • 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 use

  • 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

  • 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,

  • 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 buildi

  • 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 impr

  • 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_

  • 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_

  • 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_lis

  • 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

  • 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: ' — e.g. 'Query canc

  • 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 layou

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 11. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto nivethaug bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 20 Tagen

  • … Noch nicht geprüft

    Hat eine Lizenz

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 385 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✕ Nicht bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    4 Tool-Beschreibungen enthalten Text, der wie Anweisungen an die KI aussieht. Lies sie unten, bevor du installierst

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Mit Google anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Mit Google anmelden, um zu bewerten

Im Vergleich mit anderen in Chat & E-Maili

  • Mehr Sterne als 0 % der anderen 1940 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 22 % der anderen 1940 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 50 % der anderen 1940 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist DreamAgent sicher?

Er hat 3 von 4 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 20 Tagen geändert, und die neueste Version (1.0.0) kam vor 3 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT Business und höher.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Inbox Zero, Agent-Native Chat, draw.io

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Inbox Zero

Search Gmail and Outlook, save drafts, manage email rules, and view email stats.

von elie222Weit verbreitet★ 12.967Aktualisiert vor 41 Tagen

Läuft in der Cloud

Agent-Native Chat

Minimal chat-first app with durable threads, actions, and the app-agent loop

von BuilderIOWeit verbreitet★ 7665 Sterne des ganzen ReposAktualisiert vor 2 Monaten

Läuft in der Cloud

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

von jgraphWeit verbreitet★ 5808Aktualisiert gestern

Läuft in der Cloud✓ draw.io

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

DreamAgent MCP

Turn natural-language requests into deployed applications.

Connect ChatGPT, Claude, or any MCP client to DreamAgent — build websites, Telegram bots, Discord bots and schedulers from a conversation, watch them go live, then keep iterating.

streamable-http · OAuth 2.1 + PKCE · 24 tools · Python / FastMCP


What DreamAgent does

DreamAgent is an AI app-builder platform: you describe what you want, its agent writes the code, runs the tests, rebuilds, redeploys to production and commits to git — automatically. This MCP server exposes that power to your AI chat, so:

You: "Create a Telegram bot called WeatherBot — token 123:ABC — it replies

with the weather when I send a city name."

ChatGPT: creates it → polls → *"WeatherBot is live."*

You: "Add a /forecast command for 5-day forecasts."

ChatGPT: sends the edit → the agent codes, tests, redeploys → done.

Tools

ToolWhat it does
dreamagent_list_projectsList your projects (id, type, status, domain)
dreamagent_create_projectCreate a website / Telegram bot / Discord bot / agent project
dreamagent_get_project_statusPoll a build until ready / failed
dreamagent_chatSend a build/edit/debug instruction to the project's AI agent
dreamagent_get_chat_statusPoll an edit run (incremental output)
dreamagent_get_edit_progressEdit progress by project — no session key needed
dreamagent_list_sessionsList conversation threads per project
dreamagent_create_sessionStart a fresh topic thread
dreamagent_cancel_chatCancel a running edit
dreamagent_release_project_lockLast-resort unlock (confirm first)
dreamagent_list_filesList the project file tree
dreamagent_read_fileRead one project source file
dreamagent_edit_fileTargeted find → replace edits to an existing file (preferred for edits)
dreamagent_write_fileCreate / overwrite a file (confirm-gated, new files & full rewrites)
dreamagent_get_file_diffPending changes vs last commit
dreamagent_delete_fileDelete a file (confirm-gated)
dreamagent_commit_pushCommit + push all pending changes as one version (or retry a failed commit)
dreamagent_list_commitsVersion history (hash, message, status) — restorable in the dashboard
dreamagent_build_publishRebuild and publish the project (confirm-gated)
dreamagent_design_modeUpload a design image → agent redesigns the UI to match it
dreamagent_screenshot_websiteScreenshot any public page (returns the image + URL)
dreamagent_list_superpowersThe project's AI tool catalog (song, image, video tools)
dreamagent_list_project_envProject env var names (values masked, secrets hidden)
dreamagent_list_global_integrationsWhich providers the account owner connected

Long operations are submit-then-poll — create → poll status, edit → poll progress. Every file change is committed and pushed automatically, so each edit lands in session history and version history (restorable). The agent handles code, tests, rebuild, redeploy and git commits by itself; prompts only describe the *change*.

Connect — ChatGPT

With the official app (recommended): find *DreamAgent* in the ChatGPT app directory → Connect → sign in with your DreamAgent account (email or Google).

As a custom connector:

  1. In DreamAgent → Settings → Connect to ChatGPT → Create Key → copy the full URL (it contains your key)
  2. ChatGPT → Settings → Apps & Connectors → Advanced → Add custom connector
  3. Paste the URL as the MCP Server URL, choose OAuth (or *No authentication* — the key rides in the URL), save
  4. Ask: *"Show my DreamAgent projects"*

Connect — Claude

Claude → Settings → Connectors → Add custom connector:

  • Name: DreamAgent
  • Remote MCP server URL: https://mcp.dreamagent.cloud/mcp
  • OAuth: leave empty — Claude auto-discovers it

Click Connect, sign in with DreamAgent, done.

Connect — any MCP client

{

"mcpServers": { "dreamagent": { "type": "streamable_http", "url": "https://mcp.dreamagent.cloud/mcp" } } }

Auth is OAuth 2.1 (authorization-code + PKCE, RFC 7591 dynamic registration) — or pass a DreamAgent API key as Authorization: Bearer da_... / ?key=da_....

Example prompts

  • *"Show my DreamAgent projects"*
  • *"Create a Discord bot called PriceBot — token — it shows crypto prices with /price and /top commands"*
  • *"Is my website finished building?"*
  • *"My crypto bot stopped replying — what's wrong?"* (edits start with the agent reading the project logs)
  • *"Add a dark-mode toggle to my documentation site"*
  • *"Roll back yesterday's dashboard change"* *(via chat)*
  • *"How many AI credits do I have left?"*

How it works

ChatGPT / Claude / Glama

│ MCP (streamable HTTP) + OAuth 2.1 ▼ mcp.dreamagent.cloud ── this server (FastMCP) │ per-request Bearer = the user's own DreamAgent API key ▼ api.dreamagent.cloud ── DreamAgent platform └── agent writes code → tests → rebuild → deploy → git commit

Every request runs as the connected user — DreamAgent's ownership checks, plan limits and AI-credit billing apply exactly as in the dashboard.

Security & privacy

  • Your key, your account. OAuth issues a revocable DreamAgent API key (da_...) at connect time — visible and revocable any time in *Settings → Connect to ChatGPT*. Revoking disconnects that client instantly; other clients keep working.
  • OAuth done right. Authorization-code + PKCE (S256) mandatory, single-use 120-second codes, redirect-URI allowlists (loopback per RFC 8252), login rate-limiting, secrets validated when presented. Client registrations persist across restarts.
  • No secrets in chat. Bot tokens for Telegram/Discord travel over HTTPS to DreamAgent and are stored server-side as project env vars — the same as the dashboard's create dialog. The MCP server never logs credentials.
  • Tokens are never stored by this server — it forwards the caller's own Bearer per request and keeps no database.

Privacy: dreamagent.cloud/privacy · Terms: dreamagent.cloud/terms

Screenshots

Coming soon — a GIF of "Create a Telegram bot" end-to-end from ChatGPT.

Self-hosting / development

The hosted endpoint (mcp.dreamagent.cloud) is the easiest way to connect. To run your own:

git clone https://github.com/nivethaug/dreamagent-mcp-server

cd dreamagent-mcp-server pip install -r requirements.txt cp .env.example .env # optional: your account for local stdio mode python server.py # stdio python server.py --http --port 8800 # remote MCP (put behind HTTPS)

Hardening on the production host: the service runs under pm2 via run-mcp.sh, which joins the dedicated cgroup dreamagent-mcp-egress. Host firewall rules (/usr/local/sbin/mcp-egress-rules.sh, applied by the mcp-egress-block.service systemd unit) block NEW connections from that cgroup to all internal ranges (loopback/RFC1918/link-local/CGNAT/multicast, v4+v6) while allowing DNS and public traffic — so screenshots can never reach internal services, even through redirects or subresources.

System dependency — Chromium: the dreamagent_screenshot_website tool renders pages with a system Chromium/Chrome binary (checked in order: /usr/bin/chromium, /usr/bin/chromium-browser, /usr/bin/google-chrome, then PATH). pip does not install it — on Debian/Ubuntu:

apt-get install -y chromium          # or chromium-browser / google-chrome

Without it, every other tool works; the screenshot tool returns a clear "no headless chromium binary" error.

Three modes of authentication, in priority order per request:

  1. Authorization: Bearer da_... header (OAuth clients / API clients)
  2. ?key=da_... URL parameter (NoAuth custom connectors)
  3. DREAMAGENT_EMAIL / DREAMAGENT_PASSWORD env (personal self-host)

Layout: server.py (tools) · oauth.py (OAuth 2.1 provider: /register, /authorize, /token, /.well-known/*) · dreamagent_client.py (API client) · auth.py (login mode) · plugin/ (Codex plugin package).

OAuth client registrations persist in oauth_clients.json; extend trusted gateway callbacks via TRUSTED_OAUTH_REDIRECTS.

Links

License

MIT