dev_start
Starts a VibeView device session for live app testing and makes it the default for other tool calls, using local Metro for React Native debug builds or standalone mode for release/CI/cloud builds.
Instructions
Start a VibeView session held by this MCP server, and use it as the default session for every other tool call until dev_stop. By default it is a React Native dev loop: a debug build that loads its JS from your local Metro. Pass standalone: true to run any build as it is (a release, CI or cloud build) with no Metro. In a Flutter, Capacitor or native (not React Native) project the session is standalone automatically. Returns once the session accepts commands (device up, app installed), with the device it got (model, OS, form factor, posture) — call ui_tree next.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"platform": "<platform>"
},
"name": "dev_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | No | App id to run (from list_apps or upload_app). Must be an app for the chosen platform. Defaults to vibeview.json config, else to the app build_id belongs to. | |
| model | No | Run on this exact device model, e.g. "iPhone Duo" or "Pixel 9 Pro Fold" for a foldable (any model list_device_models marks form_factor "foldable"). Names come from list_device_models. Omit for a default phone (or TV on TV platforms). | |
| build_id | No | Run this uploaded build of the app (an id from list_builds). Without standalone it must be a debug build (kind "debug"); with standalone, or in a Flutter, Capacitor or native (not React Native) project, any build of the app works. Omitted: the newest debug build (preferring one of the local project's own app version over a newer one of another version), or with standalone the newest release build. Not for roku. | |
| platform | Yes | Platform to run on. | |
| metro_port | No | Local Metro port (default: 8081, or vibeview.json). Ignored with standalone. | |
| session_id | No | Session ID to target. Optional: falls back to the MCP-server-held dev_start session, then this project's `vibeview dev --detach` state, if either is available. | |
| standalone | No | Run the build as it is, with no Metro and no tunnel: for release builds, builds with an embedded JS bundle, CI and cloud builds. Code changes do not hot-reload. Default false. |