Cloud Android phones for AI agents: read the screen, tap, type, install APKs, park and resume.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer followed by your Mobilebox API key (from https://mobilebox.dev/dashboard)
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.
Run 1–20 actions in order, stop at the first failure, return results and the new screen. Types: tap, long_press, swipe, scroll, scroll_to {text}, type, key, back, home, open_app, close_app (force-stop), wait, wait_for. Target: {"text":"OK"} | {"ref":3} | {"id":"…"} | {"desc":"…"} | {"x":540,"y":1200}.
Phone id, ph_…
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.
Run in a terminal
claude mcp add --transport http mobilebox https://mobilebox.dev/mcp \ --header 'Authorization: Bearer YOUR_TOKEN'
Headers
Authorization (required): Bearer followed by your Mobilebox API key (from https://mobilebox.dev/dashboard)Run 1–20 actions in order, stop at the first failure, return results and the new screen. Types: tap, long_press, swipe, scroll, scroll_to {text}, type, key, back, home, open_app, close_app (force-stop), wait, wait_for. Target: {"text":"OK"} | {"ref":3} | {"id":"…"} | {"desc":"…"} | {"x":540,"y":1200}.
| Argument | Type | Description |
|---|---|---|
| actions* | array | |
| phone_id* | string | Phone id, ph_… |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"phone_id",
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"target"
],
"properties": {
"type": {
"type": "string",
"const": "tap"
},
"target": {
"anyOf": [
{
"type": "object",
"required": [
"x",
"y"
],
"properties": {
"x": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"y": {
"type": "integer",
"maximum": 10000,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "integer",
"maximum": 10000,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"text"
],
"properties": {
"nth": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"text": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"desc"
],
"properties": {
"desc": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"target"
],
"properties": {
"type": {
"type": "string",
"const": "long_press"
},
"target": {
"anyOf": [
{
"type": "object",
"required": [
"x",
"y"
],
"properties": {
"x": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"y": {
"type": "integer",
"maximum": 10000,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "integer",
"maximum": 10000,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"text"
],
"properties": {
"nth": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"text": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"desc"
],
"properties": {
"desc": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"duration_ms": {
"type": "integer",
"default": 800,
"maximum": 10000,
"minimum": 100
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"from",
"to"
],
"properties": {
"to": {
"type": "array",
"items": [
{
"type": "integer",
"maximum": 10000,
"minimum": 0
},
{
"type": "integer",
"maximum": 10000,
"minimum": 0
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"from": {
"type": "array",
"items": [
{
"type": "integer",
"maximum": 10000,
"minimum": 0
},
{
"type": "integer",
"maximum": 10000,
"minimum": 0
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"type": {
"type": "string",
"const": "swipe"
},
"duration_ms": {
"type": "integer",
"default": 300,
"maximum": 5000,
"minimum": 50
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"direction"
],
"properties": {
"type": {
"type": "string",
"const": "scroll"
},
"direction": {
"enum": [
"up",
"down",
"left",
"right"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"type": {
"type": "string",
"const": "scroll_to"
},
"direction": {
"enum": [
"up",
"down"
],
"type": "string",
"default": "down"
},
"max_swipes": {
"type": "integer",
"default": 10,
"maximum": 30,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 2000
},
"type": {
"type": "string",
"const": "type"
},
"clear": {
"type": "boolean",
"default": false
},
"submit": {
"type": "boolean",
"default": false
},
"target": {
"anyOf": [
{
"type": "object",
"required": [
"x",
"y"
],
"properties": {
"x": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"y": {
"type": "integer",
"maximum": 10000,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "integer",
"maximum": 10000,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"text"
],
"properties": {
"nth": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"text": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"desc"
],
"properties": {
"desc": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"key"
],
"properties": {
"key": {
"enum": [
"back",
"home",
"enter",
"delete",
"recents",
"tab"
],
"type": "string"
},
"type": {
"type": "string",
"const": "key"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"const": "back"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"const": "home"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"package"
],
"properties": {
"type": {
"type": "string",
"const": "open_app"
},
"package": {
"type": "string",
"maxLength": 255,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"package"
],
"properties": {
"type": {
"type": "string",
"const": "close_app"
},
"package": {
"type": "string",
"maxLength": 255,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"ms"
],
"properties": {
"ms": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"type": {
"type": "string",
"const": "wait"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"gone": {
"type": "boolean",
"default": false
},
"text": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"type": {
"type": "string",
"const": "wait_for"
},
"timeout_ms": {
"type": "integer",
"default": 10000,
"maximum": 30000,
"minimum": 100
}
},
"additionalProperties": false
}
]
},
"maxItems": 20,
"minItems": 1
},
"phone_id": {
"type": "string",
"maxLength": 64,
"description": "Phone id, ph_…"
}
}
}Create a phone, wait until it is ready and return its first screen. Give each task or end user its own phone.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| country | string | Two-letter code, e.g. DE: sets a matching timezone, locale and GPS location |
| idle_timeout | integer | Seconds without calls before it parks itself (default 300) |
| max_duration | integer | Longest session in seconds (default 900) |
| idempotency_key | string | Any unique value, e.g. a UUID. Retrying with the same key and options returns the same phone instead of a second one (24 h). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"name": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "Two-letter code, e.g. DE: sets a matching timezone, locale and GPS location"
},
"idle_timeout": {
"type": "integer",
"maximum": 3600,
"minimum": 60,
"description": "Seconds without calls before it parks itself (default 300)"
},
"max_duration": {
"type": "integer",
"maximum": 10800,
"minimum": 60,
"description": "Longest session in seconds (default 900)"
},
"idempotency_key": {
"type": "string",
"pattern": "^[\\x21-\\x7e](?:[\\x20-\\x7e]{0,62}[\\x21-\\x7e])?$",
"description": "Any unique value, e.g. a UUID. Retrying with the same key and options returns the same phone instead of a second one (24 h)."
}
}
}Delete a phone and everything on it. Prefer park_phone.
| Argument | Type | Description |
|---|---|---|
| phone_id* | string | Phone id, ph_… |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"phone_id"
],
"properties": {
"phone_id": {
"type": "string",
"maxLength": 64,
"description": "Phone id, ph_…"
}
}
}Install or update an app from a public download URL: an APK (arm64-v8a or universal) or a split bundle (.apks/.xapk; the splits this phone needs are picked). Then open it with act {"type":"open_app","package":…}.
| Argument | Type | Description |
|---|---|---|
| url* | string | Direct https link to the .apk, .apks or .xapk file |
| phone_id* | string | Phone id, ph_… |
| grant_permissions | boolean | Grant all runtime permissions up front instead of answering the dialogs |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"phone_id",
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"description": "Direct https link to the .apk, .apks or .xapk file"
},
"phone_id": {
"type": "string",
"maxLength": 64,
"description": "Phone id, ph_…"
},
"grant_permissions": {
"type": "boolean",
"description": "Grant all runtime permissions up front instead of answering the dialogs"
}
}
}Apps the user installed on this phone.
| Argument | Type | Description |
|---|---|---|
| phone_id* | string | Phone id, ph_… |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"phone_id"
],
"properties": {
"phone_id": {
"type": "string",
"maxLength": 64,
"description": "Phone id, ph_…"
}
}
}List this project's phones and their status.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Read the current screen as a numbered element list.
| Argument | Type | Description |
|---|---|---|
| phone_id* | string | Phone id, ph_… |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"phone_id"
],
"properties": {
"phone_id": {
"type": "string",
"maxLength": 64,
"description": "Phone id, ph_…"
}
}
}Park a phone: shuts it down and stops billing. Apps, data and logins stay; apps start fresh after start_phone (like after a reboot). Always park when done.
| Argument | Type | Description |
|---|---|---|
| phone_id* | string | Phone id, ph_… |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"phone_id"
],
"properties": {
"phone_id": {
"type": "string",
"maxLength": 64,
"description": "Phone id, ph_…"
}
}
}PNG of the screen, for content the element list cannot show (images, maps, games).
| Argument | Type | Description |
|---|---|---|
| phone_id* | string | Phone id, ph_… |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"phone_id"
],
"properties": {
"phone_id": {
"type": "string",
"maxLength": 64,
"description": "Phone id, ph_…"
}
}
}Set where the phone is: timezone (IANA), locale (BCP-47), GPS location, and proxy (socks5://user:pass@host:port; all traffic leaves through it, null = direct). Kept across park/start. Changing the locale restarts the UI (~15 s).
| Argument | Type | Description |
|---|---|---|
| proxy | any | |
| locale | string | |
| location | object | |
| phone_id* | string | Phone id, ph_… |
| timezone | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"phone_id"
],
"properties": {
"proxy": {
"anyOf": [
{
"type": "string",
"maxLength": 2048
},
{
"type": "null"
}
]
},
"locale": {
"type": "string",
"maxLength": 64
},
"location": {
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"phone_id": {
"type": "string",
"maxLength": 64,
"description": "Phone id, ph_…"
},
"timezone": {
"type": "string",
"maxLength": 64
}
}
}Resume a parked phone. Its apps and logins are kept.
| Argument | Type | Description |
|---|---|---|
| phone_id* | string | Phone id, ph_… |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"phone_id"
],
"properties": {
"phone_id": {
"type": "string",
"maxLength": 64,
"description": "Phone id, ph_…"
}
}
}Uninstall an app and delete its data.
| Argument | Type | Description |
|---|---|---|
| package* | string | |
| phone_id* | string | Phone id, ph_… |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"phone_id",
"package"
],
"properties": {
"package": {
"type": "string",
"maxLength": 255
},
"phone_id": {
"type": "string",
"maxLength": 64,
"description": "Phone id, ph_…"
}
}
}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 Nov 4, 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.