# Shipvo

> Shipvo is an open-source MCP server for developer tools. Open a React Native app in a simulated phone: read the screen, tap, type, set device state. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://shipvo.dev
- **Repository:** https://github.com/shipvo/shipvo/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.shipvo/shipvo
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://sim.shipvo.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "shipvo": {
      "url": "https://sim.shipvo.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/shipvo
