# demo.st

Reserves a subdomain, takes a .zip from your agent and hands back a live link like yourproject.demo.st. Built for prototypes that need a URL fast.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: demo-stage
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/demo-stage/demo.st
- Updated: 2026-03-17
- HTML: https://affpapa.org/en/nevibecode/mcp/demost

## What it does

demo.st is a stage for vibe-coded prototypes. Your agent talks to it over MCP: claim a subdomain, push the site archive, get an address that already serves something. Hosting is static only — Nginx, no PHP, no databases. A prototype that needs stateful backend work will not run here.

Five tools ship with the server. `check_subdomain_availability` needs no token and just reports whether a name is free. The other four — `reserve_subdomain`, `upload_site`, `clear_site`, `release_subdomain` — expect a Bearer token. Uploads accept either `zip_base64`, which is the easier route for an agent, or `file_url` pointing at a public archive. `clear_site` wipes the deployed content while the subdomain stays yours; only `release_subdomain` gives the name back.

Grab the token from your demo.st account: sign in, open the token page or the MCP page, copy the value. Then set `DEMO_ST_MCP_TOKEN` — `$env:` in PowerShell, `export` on macOS and Linux, or a line in `.bashrc` / `.zshrc`. Reload the editor window afterwards, otherwise the agent will not see the tools.

## Requirements
- Remote server: `https://demo.st/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http demost https://demo.st/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add demost --url https://demo.st/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "demost": {
            "url": "https://demo.st/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "demost": {
            "type": "http",
            "url": "https://demo.st/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http demost https://demo.st/mcp
```

## When to use it
- put a built prototype online without touching hosting config
- claim a free subdomain before a client call
- let the agent publish a site from inside the chat
- wipe old content but keep the same address
- check whether a name is taken before signing up

## Example prompts
- Check if the subdomain `myapp` is free and reserve it if it is
- Upload `dist.zip` as the site content and send me the link
- Clear the deployed content but keep the subdomain reserved

## Similar
- [artifact-site](https://affpapa.org/en/nevibecode/mcp/artifact-site.md) — MCP server · ★ 23
- [huawei-cloud-obs-website-host](https://affpapa.org/en/nevibecode/skills/huawei-cloud-obs-website-host.md) — skill · 16900 installs
- [convex-self-heal](https://affpapa.org/en/nevibecode/skills/convex-self-heal.md) — skill · 36100 installs
- [firecrawl-demo-walkthrough](https://affpapa.org/en/nevibecode/skills/firecrawl-demo-walkthrough.md) — skill · 31200 installs
- [base44-cli](https://affpapa.org/en/nevibecode/skills/base44-cli.md) — skill · 10900 installs
- [langgraph-cli](https://affpapa.org/en/nevibecode/skills/langgraph-cli.md) — skill · 9000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md