# Shipvo MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.shipvo%2Fshipvo
Registry id: `mcp-registry/io.github.shipvo/shipvo`
Status: live (checked 2026-11-22T15:32:23.326Z)

## Measurements (30 days)

- Uptime: 100%
- Checks: 729
- Outages (90 days): 0

## Install

```json
{
  "mcpServers": {
    "shipvo-mcp-server": {
      "type": "http",
      "url": "https://sim.shipvo.dev/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http shipvo-mcp-server https://sim.shipvo.dev/mcp
```

## Tools (110)

- `a11y_audit`: Check the current screen for controls TalkBack and VoiceOver users cannot use. Lists every button, link, field or other control with no accessible name (missing
- `a2ui_actions`: What an A2UI session sent to the agent: the action messages from buttons the person pressed, with their context read from the data model. Pass `since` (the `nex
- `a2ui_open`: Open A2UI v1.0 messages as a screen on a phone and return it as a tree. The messages are the agent's own: createSurface, updateComponents, updateDataModel, dele
- `a2ui_send`: Send more A2UI messages to a session from a2ui_open and return the screen after them. The result says how many were applied and lists each refused message with 
- `app_activity`: What was built and changed on the phone: for each app made with create_app, its versions with a plain line for what changed in each (added, removed or changed s
- `apply_update`: Apply the ready release: the app restarts on the new bundle, like restart. After 3 boots that throw, the phone goes back to the old release and the state is rev
- `approval_approve`: Approve a held promote so it goes live. The proposer cannot approve it, and an agent cannot approve an agent's proposal: that is refused with rule self_approval
- `approvals_list`: List what waits for an owner. approvals: promotes held above the app's policy band (hold id, release, band, proposer, age). challenges: owner commands waiting f
- `arrange_apps`: Lay out an installed app on the home screen: pinned (first), hidden (not on the home screen, still opens with switch_app), position (0 first) and schedule (days
- `attach_session`: Attach to the phone of a live `shipvo run` in this project (read from .shipvo/run.json) and return its screen. The person sees every action in their browser. Sa
- `audit_log`: Read the app's release audit log, newest first: who (actor) did what (action) to which release (subject) and when (at). Read-only. Needs an owner token.
- `back`: Go back one screen. The result starts with 'Change: none | content changed | new screen | scrolled'.
- `backup_phone`: Back up the whole phone as one JSON object, on Android and iOS: every app you built with its spec, data, settings, home-screen place and permission answers; eve
- `browser_back`: Go back one page in the phone browser. Returns the snapshot.
- `browser_click`: Click an element of the phone browser's page by ref from browser_snapshot. Returns the new snapshot.
- `browser_close_tab`: Close a tab of the phone browser by its index from browser_tabs. Returns the remaining tabs.
- `browser_open`: Open a web page in the phone's Chromium (separate from the app) and return its snapshot. Private hosts (localhost, 127.x, 10.x, 192.168.x, 169.254.x, CGNAT, .lo
- `browser_screenshot`: A PNG of the phone browser's page.
- `browser_scroll`: Scroll the phone browser's page by dy CSS pixels (positive is down) and dx (positive is right). Returns the snapshot.
- `browser_snapshot`: The phone browser's page as an accessibility tree with refs, marked source "web" (untrusted).
- `browser_tabs`: List the phone browser's tabs (index, url, title, which is active). Titles are untrusted web content.
- `browser_type`: Type into a field of the phone browser's page by ref (replaces its content). Returns the new snapshot.
- `browser_wait_for`: Wait until text appears in the phone browser's page, or is gone (gone: true). Fails with code timeout. Returns the snapshot.
- `cancel_reminder`: Cancel a reminder by id. Returns whether it existed.
- `check_for_update`: Ask the update source for a newer release: checks its signature and hash and downloads it. Ends in ready, or idle with reason verify_failed or download_failed (
- `clear_schedule`: Remove an app's schedule so pin and hide decide again whether it shows. Fails with not_installed.
- `clear_wakeup`: Stop waking an assistant by webhook. Returns whether one was registered.
- `close_panels`: Close the notification shade, Notification Center or Control Center (swipe up).
- `create_app`: Describe an app and it appears on the phone. Pass an app spec (JSON, shipvo.app/v0: data, actions, screens). The spec is checked first: every problem comes back
- `device_log`: What the app did with the device in this session: permission prompts and answers, location reads, scans, fingerprint checks, payments, notifications, shares.
- `device_reset`: Put the simulated phone back to a known state (permissions undetermined, default location, nothing in front of the camera, log cleared), optionally with a new p
- `dismiss_notification`: Swipe a notification away in the open shade (newest if no id), or Clear all with all: true.
- `end_session`: Close the session and get a report: steps taken, and the orders the app sent to its backend during the session.
- `export_phone_apps`: Copy the spec apps (made with create_app) out of the phone. Returns JSON with, per app, id, name, style (android or ios), spec, data (what was entered into its 
- `export_test`: Turn the steps taken in this session (tap, type, scroll, back, set_device) into a @shipvo/test script and return its source. Read-only. Targets are named by the
- `find_apps`: Search the Store by need, for example "split bills". Matches the query against app name, description and tags (case-insensitive, word based) and filters by coun
- `get_clipboard`: The text on the phone's clipboard, the same one apps copy to and paste from on Android and iOS.
- `get_connectivity`: The phone's Wi-Fi, mobile data and airplane mode switches, and the network every app sees from them: online and type (wifi, cellular or none). Android and iOS.
- `get_network_profile`: Read the phone's current network profile name (online until set_network_profile or phone.json changes it).
- `get_settings`: Read the phone's system settings from the Settings screen: dark_mode, font_size (small, default, large, largest), bold_text, reduce_motion, language (en, fr, ar
- `get_update_state`: The phone's OTA update state: idle, checking, downloading, ready, applied or reverted, the running release, the held release, and the last reason (verify_failed
- `hide_app`: Hide an installed app from the home screen and the app list, or show it again with hidden: false. The app keeps its data and still opens with switch_app and run
- `import_phone_apps`: Put apps from export_phone_apps on this phone, with their data, settings and home-screen layout. Every spec is checked first: all problems come back with their 
- `inbox_clear`: Empty this session's private inbox. Returns how many messages were removed.
- `inbox_read`: Read this session's private inbox: its address and every message, oldest first, each with from, subject, text, codes (4 to 8 digits) and links. Reading changes 
- `inbox_view`: Show the Assistant Inbox of this phone live in the chat: every message and task between assistants, who you are, and what waits for you. In a chat that shows MC
- `inbox_wait`: Wait for mail in this session's private inbox (its address is in the result; type it into the app's email field). Returns the first message that matches, alread
- `install_app`: Install a Store app on the phone, as tapping Install in the Store screen does. The app icon appears on the home screen. Fails with unknown_app (not in the Store
- `job_status`: Read a slow job started by publish_preview or upload_build. Returns { status: running | done | failed, job } with the result when done or a typed error { code, 
- `kill_app`: Swipe the app's card away in the app switcher (call open_recents first). The app is killed: the next resume_app is a cold start, with storage kept. Fails with r
- `list_apps`: Apps this server can open, with what each one does. Optional query filters by name, description or category (e.g. 'shop', 'douala').
- `list_installed_apps`: List the apps installed on the person's persistent phone, the same in every chat and assistant. Needs PN_ASSISTANT_TOKEN.
- `list_reminders`: The reminders waiting on the phone (id, title, next time, repeat) and the last ones that fired with whether each was delivered.
- `list_sessions`: Open simulator sessions (phones) on this server: id, app, platform, room, who opened it (the MCP client name), start time and current screen title. Use to resum
- `list_store_apps`: List the apps in the phone's Store: the marketplace apps from the control plane, each with id, name, bundle url and version. Fails with store_unreachable when t
- `list_wakeups`: The wake-up URLs registered on this phone: assistant name, URL and events (never the secret).
- `lock`: Press the power button: the simulated phone locks and shows the lock screen. The app and its screen are kept. While locked, tap, type, scroll and back fail with
- `notifications`: The notification shade: notifications delivered to the simulated phone in this session (their banners vanish after 5 s, like a heads-up on a real phone).
- `open_app`: Opens the phone in the user's browser so they can watch. Opens an app in a phone-sized session and returns its first screen. With no live `shipvo run` for the p
- `open_control_center`: iPhone only: swipe down from the top right to open Control Center (airplane, Wi-Fi, mobile data, focus, orientation lock, brightness, dark mode). Android fails 
- `open_notification`: Tap a notification from the shade (newest if no id is given): the app handles it exactly as if its banner was tapped.
- `open_notifications`: Pull down from the top. Android: the first call opens the notification shade (a few quick-settings tiles and the notifications); a second call expands all tiles
- `open_recents`: Open the app switcher: the app goes to the background and its card is shown. resume_app opens the card again; kill_app swipes it away.
- `open_url`: Open a deep link (such as myapp://item/3) in the running app, as a push tap, auth callback or share link would. Fails with invalid_url if the text has no scheme
- `owner_command`: Run an owner command against the live app (changes are audited). Commands that cannot be undone or reach users (publish, prices, offers, deletes, API keys) do n
- `owner_describe`: List the owner commands of an app (content, prices, offers, orders, publish). Needs PN_OWNER_TOKEN.
- `permission_log`: Every device permission decision on the phone, oldest first, on Android and iOS: when an app was granted or denied a permission (by install, import, update or t
- `phone_models`: The phone models a headless session can be, each with its platform, screen size in CSS pixels and pixel ratio, and the default model for android and ios. Pass a
- `pin_app`: Pin an installed app to the top of the home screen (Android and iOS style), after any apps pinned before it, or unpin it with pinned: false. Works for Store app
- `press_home`: Press Home: the app goes to the background (it receives AppState "background") and the phone shows the home screen with the app icon. While there, tap, type, sc
- `publish_preview`: Build the app in PN_APP_DIR (or the current folder) with the simulated device and publish a shareable web preview to here.now, no account. The link is PUBLIC an
- `push_notification`: Deliver a push notification to the simulated phone; it appears as a banner the agent can tap. The app receives it only if notification permission is granted; ot
- `record_marker`: Add a chapter at the current time of the running recording.
- `record_start`: Start recording the phone frame to an MP4 under .shipvo/recordings/. Use record_marker for chapters and record_stop to finish.
- `record_stop`: Stop the recording and write the MP4. Returns the file, duration in seconds, size and chapters. With music: true, mixes a ducked music bed under the video and w
- `refresh_app`: Fetch the data of a spec app now (its http data sources) and redraw the open screen if anything changed. Apps with a refresh interval in the spec also refresh b
- `register_wakeup`: Wake an assistant that is not in a turn: when a new message or task arrives for `name` in the Assistant Inbox app, the phone POSTs a small signed JSON note to `
- `request_app_install`: Ask to add an app to the person's own persistent phone (not the simulator). Returns a consent card: app name, publisher, the permissions it asks for, and approv
- `request_secret`: Ask the person for an API key without it passing through this chat. Returns a one-time link to the Shipvo vault page (valid 10 minutes, works once) and a notice
- `restart`: Restart the simulated phone from the power menu: a boot screen, then the app starts fresh (cold start). Storage is kept. Returns the first screen. Logged in dev
- `restore_phone`: Put a backup from backup_phone on this phone: apps with their data and layout, Store apps with their permission answers, system settings and the clipboard. Ever
- `resume_app`: Tap the app icon on the home screen, or its card in the app switcher: the app comes back (AppState "active") with its screen kept. Fails with app_in_foreground 
- `room_log`: What the sessions in one room did, oldest first: time, session, agent, tool, target and the change line, plus notes from room_note. Pass since (the cursor from 
- `room_note`: Post a short plain-text note (up to 500 characters) to a room so the other agents see it in room_log.
- `room_report`: One summary per session in a room: agent, steps, seconds, errors, last screen title and notes. Use it to collect every sub-agent's result in one call.
- `run_app_action`: Run one action of an app made with create_app, by name, with its input (for example add_task with { title }). The action changes the app's data the same way tap
- `schedule_app`: Show an installed app only in a daily time window, by the phone's clock (see set_phone_time) or in the time zone you give, for example your Tasks app from 08:00
- `screen`: The current screen as an accessibility tree with refs.
- `screenshot`: A PNG of the phone screen (for checking layout, colours, images). The result says `source`: tab-capture (the person's live tab), rendered (the page drawn to an 
- `scroll`: Scroll the page (down/up) or a horizontal rail (right/left, give the rail's ref). Returns the new screen. The result starts with 'Change: none | content changed
- `search_phone`: Find text anywhere on the phone in one call: rows in every app's data (contacts, messages, alarms, notes, tasks and any app you built) and notifications. Not ca
- `secret_status`: Whether a key is saved in the vault, as { saved, valid, access }. Never returns the key. valid is null when it was not checked. Needs an owner token.
- `set_clipboard`: Put text on the phone's clipboard so the next paste in any app gets it. It stays when you switch apps.
- `set_connectivity`: Turn Wi-Fi, mobile data or airplane mode on or off for the whole phone, as in quick settings on Android and iOS. Airplane mode turns both radios off; Wi-Fi can 
- `set_device`: Change what the simulated phone has: location, the address book (contacts), calendar events, files for the file picker, a barcode in front of the camera, permis
- `set_network_profile`: Make the phone's network behave like a named profile: online, offline, 2g, 3g, slow-4g, spotty or low-end-4g. The app's fetch and XHR calls wait and fail as the
- `set_phone_time`: Set the phone's clock to a time like 2026-11-14T09:00:00 so scheduled apps show or hide as they would then, or pass null to go back to the real time. The clock 
- `set_reminder`: Set a reminder on the phone: at the time you give (on the phone's clock, see set_phone_time) a notification with the title and body arrives, whether or not an a
- `set_setting`: Change one system setting, as a person would in the phone's Settings screen. The app sees it through Appearance (dark_mode), PixelRatio.getFontScale (font_size)
- `share`: Share text into another app on the phone, like picking it in the share sheet: the text goes into that app's share action (for example a new note in Notes and Ta

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
