Skip to main content

MCP Tools Overview

vibeD exposes MCP tools that an AI agent calls to deploy and manage apps. deploy_artifact runs the full flow: it classifies the source, creates a VibedApp, claims a warm sandbox, injects the source, and returns a URL.

Terminology

The tool names still use "artifact" for backward compatibility, but a deploy now produces a VibedApp running on a sandbox — see App lifecycle. There is no separate "build" or "preview/promote" step anymore.

Available Tools

ToolDescription
deploy_artifactDeploy a source tree; returns a URL once the app is Ready
list_artifactsList the caller's apps
get_artifact_statusGet status, phase, and URL for one app
update_artifactRedeploy an app with new source
delete_artifactTear an app down
get_artifact_logsRetrieve logs
list_deployment_targetsShow available runtime templates
list_versionsList version snapshots for an app
rollback_artifactRoll back to a previous version
share_artifact / unshare_artifactGrant / revoke read access
create_share_link / list_share_links / revoke_share_linkManage public share links

User/department admin tools (get_user, list_users, create_department, list_departments) are also exposed when auth is enabled.

caution

Some endpoints behind these tools are not yet fully wired (live log streaming, redeploy, rollback/versions, and snapshot-based suspend). The deploy → list → status → delete path is the supported core.

Transport

The MCP server is exposed over HTTP streamable at /mcp (the vibed server's port). For Claude Desktop, bridge to it with mcp-remote — see First deployment. stdio transport is also available via server.transport: stdio.