Skip to content
MCP server

Shipvo

Open a React Native app in a simulated phone: read the screen, tap, type, set device state

Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally or Remotely
Version
0.0.6
Listing updated
3 days ago

About Shipvo

Shipvo is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

An agent gets a headless phone instead of an emulator. It reads the screen as an accessibility tree, taps, types, scrolls and takes screenshots, and each result opens with a line stating whether the change was none, content changed, new screen or scrolled. Results carry only changed lines to save tokens, and tap accepts a path to follow several elements in one call.

Device state is scriptable too: set_device can change things like payment outcome, biometrics and location, so an agent can test a declined payment without a real device. Two guard options matter for safety: SHIPVO_GUARD makes taps on payment or account-delete buttons wait for a person, and text typed into password or one-time-code fields is kept out of results and exports.

The server pairs with the open-source Shipvo framework, which adds signed over-the-air updates. It runs locally with npx @shipvo/mcp against shipvo sim, or against the hosted simulator at sim.shipvo.dev, which is free during the beta with a 600-minute test key valid for 30 days. The software is Apache-2.0.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://sim.shipvo.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "shipvo": {
      "url": "https://sim.shipvo.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "shipvo": {
      "type": "http",
      "url": "https://sim.shipvo.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shipvo": {
      "serverUrl": "https://sim.shipvo.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

list_apps
Lists apps the simulator serves
phone_models
Lists available phone models
open_app
Opens an app by id
screen
Reads the current screen
tap
Taps an element by ref or visible name, or a path of them
type
Types text into a field
scroll
Scrolls the screen
back
Navigates back
screenshot
Takes a screenshot
set_device
Sets device state such as location or payment result
device_log
Reads what the app sent to its backend
open_url
Opens a URL
wait_for_event
Waits for an event
end_session
Ends the session

What it does

Accessibility-tree screens
Agents read the app's screen as text and act on element refs.
Change summaries
Each action reports what changed to keep output short.
Scriptable device state
Set payment results, biometrics and location for tests.
Tap guard
Optionally hold payment and delete taps for human approval.
Secret-field hiding
Passwords and one-time codes stay out of results and exports.
Short tool list
SHIPVO_MCP_TOOLS=core lists only the essential tools.

Good for

  • Run an agent through checkout and verify a declined payment places no order
  • Test permission prompts and offline behaviour in CI
  • Capture screenshots of a live simulated phone
  • Have an agent walk a release before customers get it

Pricing

Open source

Apache-2.0; hosted simulator free during beta

Prices change. Check shipvo.dev before you buy.

Shipvo FAQ

Do I need a device or emulator?

No. The simulator is headless and runs on a laptop or a Linux CI runner.

What does hosted use cost?

Free during the beta; a test key has 600 sandbox minutes valid for 30 days.

Can it pay for things?

With SHIPVO_GUARD on, payment and delete taps wait for a person.

What licence?

Apache-2.0.

Is Shipvo free?

Yes. Shipvo is open source, so you can use and self-host it for free.

How do I add Shipvo to Claude Code?

Run this command in your terminal: claude mcp add --transport http shipvo https://sim.shipvo.dev/mcp

What are the best alternatives to Shipvo?

The closest alternatives to Shipvo are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Shipvo

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools