{
  "markdown": "<div align=\"center\">\n\n# DreamAgent MCP\n\n**Turn natural-language requests into deployed applications.**\n\nConnect ChatGPT, Claude, or any MCP client to [DreamAgent](https://dreamagent.cloud) —\nbuild websites, Telegram bots, Discord bots and schedulers from a conversation,\nwatch them go live, then keep iterating.\n\n`streamable-http` · OAuth 2.1 + PKCE · 10 tools · Python / [FastMCP](https://gofastmcp.com)\n\n</div>\n\n---\n\n## What DreamAgent does\n\n[DreamAgent](https://dreamagent.cloud) is an AI app-builder platform: you describe\nwhat you want, its agent writes the code, runs the tests, rebuilds, redeploys to\nproduction and commits to git — automatically. This MCP server exposes that\npower to your AI chat, so:\n\n> **You:** \"Create a Telegram bot called WeatherBot — token `123:ABC` — it replies\n> with the weather when I send a city name.\"\n>\n> **ChatGPT:** creates it → polls → *\"WeatherBot is live.\"*\n>\n> **You:** \"Add a /forecast command for 5-day forecasts.\"\n>\n> **ChatGPT:** sends the edit → the agent codes, tests, redeploys → done.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `dreamagent_list_projects` | List your projects (id, type, status, domain) |\n| `dreamagent_create_project` | Create a website / Telegram bot / Discord bot / scheduler |\n| `dreamagent_get_project_status` | Poll a build until `ready` / `failed` |\n| `dreamagent_chat` | Send a build/edit/debug instruction to the project's AI agent |\n| `dreamagent_get_chat_status` | Poll an edit run (incremental output) |\n| `dreamagent_get_edit_progress` | Edit progress by project — no session key needed |\n| `dreamagent_list_sessions` | List conversation threads per project |\n| `dreamagent_create_session` | Start a fresh topic thread |\n| `dreamagent_cancel_chat` | Cancel a running edit |\n| `dreamagent_release_project_lock` | Last-resort unlock (confirm first) |\n\nLong operations are **submit-then-poll** — create → poll status, edit → poll\nprogress. The agent handles code, tests, rebuild, redeploy and git commits by\nitself; prompts only describe the *change*.\n\n## Connect — ChatGPT\n\n**With the official app (recommended):** find *DreamAgent* in the ChatGPT app\ndirectory → **Connect** → sign in with your DreamAgent account (email or\nGoogle).\n\n**As a custom connector:**\n\n1. In DreamAgent → **Settings → Connect to ChatGPT** → **Create Key** → copy\n   the full URL (it contains your key)\n2. ChatGPT → **Settings → Apps & Connectors → Advanced** → **Add custom connector**\n3. Paste the URL as the **MCP Server URL**, choose **OAuth** (or *No\n   authentication* — the key rides in the URL), save\n4. Ask: *\"Show my DreamAgent projects\"*\n\n## Connect — Claude\n\nClaude → **Settings → Connectors → Add custom connector**:\n\n- **Name:** `DreamAgent`\n- **Remote MCP server URL:** `https://mcp.dreamagent.cloud/mcp`\n- **OAuth:** leave empty — Claude auto-discovers it\n\nClick **Connect**, sign in with DreamAgent, done.\n\n## Connect — any MCP client\n\n```json\n{\n  \"mcpServers\": {\n    \"dreamagent\": {\n      \"type\": \"streamable_http\",\n      \"url\": \"https://mcp.dreamagent.cloud/mcp\"\n    }\n  }\n}\n```\n\nAuth is OAuth 2.1 (authorization-code + PKCE, RFC 7591 dynamic registration)\n— or pass a DreamAgent API key as `Authorization: Bearer da_...` /\n`?key=da_...`.\n\n## Example prompts\n\n- *\"Show my DreamAgent projects\"*\n- *\"Create a Discord bot called PriceBot — token `<from Discord dev portal>` —\n  it shows crypto prices with /price and /top commands\"*\n- *\"Is my website finished building?\"*\n- *\"My crypto bot stopped replying — what's wrong?\"* (edits start with the\n  agent reading the project logs)\n- *\"Add a dark-mode toggle to my documentation site\"*\n- *\"Roll back yesterday's dashboard change\"* *(via chat)*\n- *\"How many AI credits do I have left?\"*\n\n## How it works\n\n```\nChatGPT / Claude / Glama\n   │  MCP (streamable HTTP) + OAuth 2.1\n   ▼\nmcp.dreamagent.cloud ── this server (FastMCP)\n   │  per-request Bearer = the user's own DreamAgent API key\n   ▼\napi.dreamagent.cloud ── DreamAgent platform\n   └── agent writes code → tests → rebuild → deploy → git commit\n```\n\nEvery request runs as the connected user — DreamAgent's ownership checks,\nplan limits and AI-credit billing apply exactly as in the dashboard.\n\n## Security & privacy\n\n- **Your key, your account.** OAuth issues a revocable DreamAgent API key\n  (`da_...`) at connect time — visible and revocable any time in\n  *Settings → Connect to ChatGPT*. Revoking disconnects that client instantly;\n  other clients keep working.\n- **OAuth done right.** Authorization-code + **PKCE (S256) mandatory**,\n  single-use 120-second codes, redirect-URI allowlists (loopback per RFC 8252),\n  login rate-limiting, secrets validated when presented. Client registrations\n  persist across restarts.\n- **No secrets in chat.** Bot tokens for Telegram/Discord travel over HTTPS\n  to DreamAgent and are stored server-side as project env vars — the same as\n  the dashboard's create dialog. The MCP server never logs credentials.\n- **Tokens are never stored** by this server — it forwards the caller's own\n  Bearer per request and keeps no database.\n\nPrivacy: [dreamagent.cloud/privacy](https://dreamagent.cloud/privacy) ·\nTerms: [dreamagent.cloud/terms](https://dreamagent.cloud/terms)\n\n## Screenshots\n\n<!-- TODO: add demo GIF (chat creating a bot) + screenshot of connector setup -->\n\n```\nComing soon — a GIF of \"Create a Telegram bot\" end-to-end from ChatGPT.\n```\n\n## Self-hosting / development\n\nThe hosted endpoint (`mcp.dreamagent.cloud`) is the easiest way to connect.\nTo run your own:\n\n```bash\ngit clone https://github.com/nivethaug/dreamagent-mcp-server\ncd dreamagent-mcp-server\npip install -r requirements.txt\ncp .env.example .env          # optional: your account for local stdio mode\npython server.py              # stdio\npython server.py --http --port 8800   # remote MCP (put behind HTTPS)\n```\n\nThree modes of authentication, in priority order per request:\n\n1. `Authorization: Bearer da_...` header (OAuth clients / API clients)\n2. `?key=da_...` URL parameter (NoAuth custom connectors)\n3. `DREAMAGENT_EMAIL` / `DREAMAGENT_PASSWORD` env (personal self-host)\n\nLayout: `server.py` (tools) · `oauth.py` (OAuth 2.1 provider: `/register`,\n`/authorize`, `/token`, `/.well-known/*`) · `dreamagent_client.py` (API\nclient) · `auth.py` (login mode) · `plugin/` (Codex plugin package).\n\nOAuth client registrations persist in `oauth_clients.json`; extend trusted\ngateway callbacks via `TRUSTED_OAUTH_REDIRECTS`.\n\n## Links\n\n- **DreamAgent** — [dreamagent.cloud](https://dreamagent.cloud)\n- Documentation — [dreamagent.cloud/documentation](https://dreamagent.cloud/documentation)\n- Help & Support — [dreamagent.cloud/help](https://dreamagent.cloud/help)\n- Support — support@dreamagent.cloud\n\n## License\n\nMIT\n",
  "bytes": 6703,
  "sha": "001fe3c7a474dd813bf41ed92bcb5b023f9bf535338aefb4f0987681aaa9afa6",
  "repo_slug": "nivethaug/dreamagent-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nivethaug_dreamagent_27731926/readme"
}