emergent-mcp

emergent-mcp

MCP server for Emergent.sh — control the AI-powered full-stack app builder from any MCP-compatible agent.

Build apps, monitor progress, respond to agent questions, preview results, and track credit usage — all from your AI assistant.

Quick Start

npx @openclaw/emergent-mcp

Required env vars:

export EMERGENT_EMAIL="you@example.com"
export EMERGENT_PASSWORD="yourpassword"

Or run the interactive login helper:

npx @openclaw/emergent-mcp-login

Installation

Claude Desktop / Claude Code / Cursor

Add to your MCP config (claude_desktop_config.json or .cursor/mcp.json):

{
  "mcpServers": {
    "emergent": {
      "command": "npx",
      "args": ["-y", "@openclaw/emergent-mcp"],
      "env": {
        "EMERGENT_EMAIL": "you@example.com",
        "EMERGENT_PASSWORD": "yourpassword"
      }
    }
  }
}

OpenClaw

Add to your OpenClaw config:

mcp:
  servers:
    - name: emergent
      command: npx -y @openclaw/emergent-mcp
      env:
        EMERGENT_EMAIL: you@example.com
        EMERGENT_PASSWORD: yourpassword

Available Tools

| Tool | Description | |------|-------------| | emergent_create_project | Create a new project by submitting a prompt | | emergent_list_projects | List recent projects with status | | emergent_get_project | Get full details for a specific project | | emergent_wait_for_build | Poll until a build completes | | emergent_respond_to_agent | Answer a HITL question from the agent | | emergent_wake_environment | Wake a sleeping environment | | emergent_get_preview | Get the live preview URL | | emergent_screenshot_preview | Screenshot preview at phone/tablet/laptop/TV sizes | | emergent_get_credits | Get full credit balance details | | emergent_credit_summary | Get a short credit balance string |

Example Usage

Ask your AI assistant:

"Create a landing page for my coffee shop in Bangalore using emergent-mcp. The shop is called 'Brew & Co', has a 4.9★ rating, and their number is +91 98765 43210. Then take screenshots at phone and laptop sizes."

The agent will:

1. Call emergent_get_credits to note starting balance
2. Call emergent_create_project with your prompt
3. Call emergent_wait_for_build to poll until done
4. Call emergent_get_preview to get the live URL
5. Call emergent_screenshot_preview for the screenshots
6. Call emergent_get_credits again to report credits used

Architecture

This MCP server uses the Emergent REST API directly (no browser automation needed for core operations). Authentication uses the Supabase backend that powers Emergent.

Credentials are cached in ~/.emergent-mcp/api-token.json and refreshed automatically.

For operations not yet in the REST API (e.g., deployment), the server falls back to Playwright browser automation.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | EMERGENT_EMAIL | Yes | Account email | | EMERGENT_PASSWORD | Yes | Account password |

*Not required if you've already logged in via emergent-mcp-login (session cached).

License

MIT