Deploy from Grok Build
Deploy to a live URL from xAI's Grok Build CLI. Connect via MCP server (OAuth, interactive) or the vibehost CLI (scripted, PAT).
Grok Build is xAI's terminal-based coding agent, available to SuperGrok and X Premium+ subscribers. It can deploy to VibeHost two ways: through our MCP server (interactive, OAuth) or through the vibehost CLI wrapped as a tool (scripted, PAT).
VibeHost is a private-by-default hosting platform that gives AI-built apps a permanent, shareable URL. Its official remote MCP server covers deployments, custom domains, access control, and team collaboration, and any MCP-compatible coding agent can connect to it with a single URL. Grok Build is one of ten officially supported coding agents.
Option 1: MCP server (recommended for interactive use)
Add VibeHost to your Grok Build MCP config. The standard path is .mcp.json in your project root, or ~/.grok/.mcp.json for global access across all projects.
{
"mcpServers": {
"vibehost": {
"url": "https://api.vibehost.com/mcp"
}
}
}If your Grok Build version does not pick up the remote server with url, use mcp-remote as a local bridge instead:
{
"mcpServers": {
"vibehost": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.vibehost.com/mcp"]
}
}
}Restart Grok Build or run /mcp in the TUI to reload. First tool call opens your browser for OAuth. After approval, Grok Build has access to every VibeHost tool, so it can deploy, promote, roll back, read logs, and manage custom domains.
Verify the server is discovered:
grok inspectIn a Grok Build session, describe what you want:
Deploy this directory to VibeHost as a new app called my-grok-app. It's a Vite + React build.
Grok Build creates the app, uploads the files, deploys them and returns the live URL. The tool calls behind that are described once, in Choosing an upload path.
Option 2: CLI as a tool (recommended for scripts and CI)
Install the CLI:
curl -fsSL -o vibehost-install.sh https://vibehost.com/install.sh
cat vibehost-install.sh
sh vibehost-install.sh && rm vibehost-install.shInstall the vibehost-deploy skill so Grok Build auto-discovers it via its plugin system:
npx skills add gntc-labs/skills --skill vibehost-deploy -g -y -a grokOr from inside the Grok Build TUI, run /plugin to search and install vibehost-deploy.
For local interactive use, sign in once with the CLI:
vibehost login
vibehost whoami --jsonvibehost login opens a browser approval flow and stores the CLI token in ~/.config/vibehost/config.json.
For CI or unattended scripts, use a Personal Access Token instead:
export VIBEHOST_TOKEN="<your-personal-access-token>"
vibehost whoami --jsonGrok Build can shell out to vibehost deploy ./dist, vibehost app inspect, etc. Every command takes --json and returns {ok, data | error}, which an agent can parse without reading prose. See the CLI reference.
When to pick which
| Situation | Use |
|---|---|
| First-time setup | MCP (browser sign-in, no token to paste) |
| Interactive deploys from Grok Build | MCP |
| Local shell-driven deploys | CLI after vibehost login |
| CI / unattended workflows | CLI + VIBEHOST_TOKEN env |
| You want every write to prompt for confirmation | MCP |
| You want raw stdout / stderr from the deploy | CLI |
Both can coexist. Set up MCP for interactive sessions and keep the CLI installed for scripts.
FAQ
Does Grok Build support VibeHost natively?
Yes. VibeHost is an officially supported MCP integration for Grok Build. Add the MCP server URL to your .mcp.json config and Grok Build discovers every VibeHost tool automatically. No plugin or extension required.
Do I need to install anything to use VibeHost with Grok Build?
Not for the MCP path. It needs only a config entry and an OAuth approval. For the CLI path, install the vibehost CLI with a one-line curl command, or install the vibehost-deploy skill via /plugin in the Grok Build TUI.
Can I use both MCP and CLI at the same time? Yes. Both can coexist. MCP is best for interactive sessions where Grok Build picks the right tools automatically. The CLI is best for scripted workflows, CI pipelines, or when you want raw stdout/stderr output.
See also
- MCP server lists every tool and explains authentication.
- Personal access tokens covers PAT setup for CI and scripts.
- Sibling coding agents: Claude Code, Codex CLI, Cursor, Antigravity, Antigravity CLI, Windsurf, OpenCode, Copilot CLI, Hermes Agent
Deploy from Hermes Agent
Use VibeHost from inside Hermes Agent, Nous Research's open-source self-improving terminal agent. MCP server or vibehost CLI as a tool.
MCP server
Wire any MCP-compatible client to VibeHost. The MCP server is the path for coding agents (Claude Code, Codex, Cursor, Antigravity, Grok Build) and chat clients (ChatGPT, Claude Desktop, Gemini Spark) that don't have a native CLI tool channel.