Open a React Native app in a simulated phone: read the screen, tap, type, set device state.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <key from `npx @shipvo/cli login`>
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Go back one screen.
Session from open_app
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
claude mcp add --transport http shipvo https://sim.shipvo.dev/mcp \ --header 'Authorization: Bearer YOUR_TOKEN'
Headers
Authorization (required): Bearer <key from `npx @shipvo/cli login`>Go back one screen.
| Argument | Type | Description |
|---|---|---|
| session* | string | Session from open_app |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session"
],
"properties": {
"session": {
"type": "string",
"description": "Session from open_app"
}
},
"additionalProperties": false
}What the app did with the device in this session: permission prompts and answers, location reads, scans, fingerprint checks, payments, notifications, shares.
| Argument | Type | Description |
|---|---|---|
| session* | string | Session from open_app |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session"
],
"properties": {
"session": {
"type": "string",
"description": "Session from open_app"
}
},
"additionalProperties": false
}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 profile.
| Argument | Type | Description |
|---|---|---|
| api | number | |
| session* | string | Session from open_app |
| platform | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session"
],
"properties": {
"api": {
"type": "number"
},
"session": {
"type": "string",
"description": "Session from open_app"
},
"platform": {
"enum": [
"android",
"ios"
],
"type": "string"
}
},
"additionalProperties": false
}Close the session and get a report: steps taken, and the orders the app sent to its backend during the session.
| Argument | Type | Description |
|---|---|---|
| session* | string | Session from open_app |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session"
],
"properties": {
"session": {
"type": "string",
"description": "Session from open_app"
}
},
"additionalProperties": false
}Apps this server can open, with what each one does. Optional query filters by name, description or category (e.g. 'shop', 'douala').
| Argument | Type | Description |
|---|---|---|
| query | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "string"
}
},
"additionalProperties": false
}Open simulator sessions (phones) on this server: id, app, release and when each started. Use to resume after a reconnect.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}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).
| Argument | Type | Description |
|---|---|---|
| session* | string | Session from open_app |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session"
],
"properties": {
"session": {
"type": "string",
"description": "Session from open_app"
}
},
"additionalProperties": false
}Open an app in a fresh phone-sized session and return its first screen.
| Argument | Type | Description |
|---|---|---|
| app* | string | App id from list_apps, optionally with a release: 'tide' (local build), 'tide@latest' or 'tide@r13' (the published release phones run) |
| dark | boolean | Dark mode |
| session | string | Session name (default: generated). One session is one phone. |
| seed_cart | array | Start with these items already in the cart (test shortcut). Each line: { product_id, quantity }; { id, qty } also works. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app"
],
"properties": {
"app": {
"type": "string",
"description": "App id from list_apps, optionally with a release: 'tide' (local build), 'tide@latest' or 'tide@r13' (the published release phones run)"
},
"dark": {
"type": "boolean",
"description": "Dark mode"
},
"session": {
"type": "string",
"description": "Session name (default: generated). One session is one phone."
},
"seed_cart": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"qty": {
"type": "integer",
"exclusiveMinimum": 0
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0
},
"product_id": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Start with these items already in the cart (test shortcut). Each line: { product_id, quantity }; { id, qty } also works."
}
},
"additionalProperties": false
}Tap a notification from the shade (newest if no id is given): the app handles it exactly as if its banner was tapped.
| Argument | Type | Description |
|---|---|---|
| id | string | |
| session* | string | Session from open_app |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session"
],
"properties": {
"id": {
"type": "string"
},
"session": {
"type": "string",
"description": "Session from open_app"
}
},
"additionalProperties": false
}Run an owner command against the live app (changes are audited; `publish` makes them live on every phone within seconds).
| Argument | Type | Description |
|---|---|---|
| app* | string | |
| args | object | |
| command* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app",
"command"
],
"properties": {
"app": {
"type": "string"
},
"args": {
"type": "object",
"additionalProperties": {}
},
"command": {
"type": "string"
}
},
"additionalProperties": false
}List the owner commands of an app (content, prices, offers, orders, publish). Needs PN_OWNER_TOKEN.
| Argument | Type | Description |
|---|---|---|
| app* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app"
],
"properties": {
"app": {
"type": "string"
}
},
"additionalProperties": false
}Deliver a push notification to the simulated phone; it appears as a banner the agent can tap.
| Argument | Type | Description |
|---|---|---|
| body* | string | |
| data | object | |
| title* | string | |
| session* | string | Session from open_app |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session",
"title",
"body"
],
"properties": {
"body": {
"type": "string"
},
"data": {
"type": "object",
"additionalProperties": {}
},
"title": {
"type": "string"
},
"session": {
"type": "string",
"description": "Session from open_app"
}
},
"additionalProperties": false
}The current screen as an accessibility tree with refs.
| Argument | Type | Description |
|---|---|---|
| session* | string | Session from open_app |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session"
],
"properties": {
"session": {
"type": "string",
"description": "Session from open_app"
}
},
"additionalProperties": false
}A PNG of the phone screen (for checking layout, colours, images). The tree from `screen` is usually enough to act.
| Argument | Type | Description |
|---|---|---|
| session* | string | Session from open_app |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session"
],
"properties": {
"session": {
"type": "string",
"description": "Session from open_app"
}
},
"additionalProperties": false
}Scroll the page (down/up) or a horizontal rail (right/left, give the rail's ref). Returns the new screen.
| Argument | Type | Description |
|---|---|---|
| ref | string | Scroll inside this element (a rail or list); omit for the page |
| session* | string | Session from open_app |
| direction* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session",
"direction"
],
"properties": {
"ref": {
"type": "string",
"pattern": "^e\\d+$",
"description": "Scroll inside this element (a rail or list); omit for the page"
},
"session": {
"type": "string",
"description": "Session from open_app"
},
"direction": {
"enum": [
"down",
"up",
"left",
"right"
],
"type": "string"
}
},
"additionalProperties": false
}Change what the simulated phone has: location, a barcode in front of the camera, permission states, whether the fingerprint will match, whether a payment will be approved, network on/off. Takes effect for the next action.
| Argument | Type | Description |
|---|---|---|
| camera | object | |
| online | boolean | |
| payment | object | |
| session* | string | Session from open_app |
| location | object | |
| biometrics | object | |
| permissions | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session"
],
"properties": {
"camera": {
"type": "object",
"properties": {
"barcode": {
"anyOf": [
{
"type": "object",
"required": [
"type",
"data"
],
"properties": {
"data": {
"type": "string"
},
"type": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"delayMs": {
"type": "number"
}
},
"additionalProperties": false
},
"online": {
"type": "boolean"
},
"payment": {
"type": "object",
"properties": {
"pin": {
"type": "string"
},
"nextResult": {
"enum": [
"approve",
"decline",
"timeout",
"insufficient_funds"
],
"type": "string"
}
},
"additionalProperties": false
},
"session": {
"type": "string",
"description": "Session from open_app"
},
"location": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"accuracy": {
"type": "number"
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
}
},
"additionalProperties": false
},
"biometrics": {
"type": "object",
"properties": {
"enrolled": {
"type": "boolean"
},
"nextResult": {
"enum": [
"success",
"fail",
"cancel"
],
"type": "string"
}
},
"additionalProperties": false
},
"permissions": {
"type": "object",
"properties": {
"camera": {
"enum": [
"granted",
"denied",
"undetermined"
],
"type": "string"
},
"location": {
"enum": [
"granted",
"denied",
"undetermined"
],
"type": "string"
},
"notifications": {
"enum": [
"granted",
"denied",
"undetermined"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Tap a button, link or choice by ref. Returns the new screen.
| Argument | Type | Description |
|---|---|---|
| ref* | string | Element ref from the screen, e.g. e42 |
| session* | string | Session from open_app |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session",
"ref"
],
"properties": {
"ref": {
"type": "string",
"pattern": "^e\\d+$",
"description": "Element ref from the screen, e.g. e42"
},
"session": {
"type": "string",
"description": "Session from open_app"
}
},
"additionalProperties": false
}Type into a text field by ref (replaces its content). Returns the new screen.
| Argument | Type | Description |
|---|---|---|
| ref* | string | Element ref from the screen, e.g. e42 |
| text* | string | |
| enter | boolean | Press Enter afterwards |
| session* | string | Session from open_app |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"session",
"ref",
"text"
],
"properties": {
"ref": {
"type": "string",
"pattern": "^e\\d+$",
"description": "Element ref from the screen, e.g. e42"
},
"text": {
"type": "string"
},
"enter": {
"type": "boolean",
"description": "Press Enter afterwards"
},
"session": {
"type": "string",
"description": "Session from open_app"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Oct 31, 2026.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.