list_phones
List this workspace's phones with their status, model, and region.
MCP tools
19 tools, grouped by what they act on. Tools marked “Changes state” are hidden from read-only keys.
Phones
get_phone
Get one phone by id.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | Phone id. |
list_phone_apps
List the packages installed on one phone that have a launcher entry — the apps send_order can actually open. Start here when choosing what to drive; the install catalog is a separate, usually smaller list of what may be added.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | Phone id. |
allocate_phonesChanges state
Claim ready phones for this workspace, within its phone quota.
| Parameter | Type | Description |
|---|---|---|
count | integer | How many phones. Default 1. |
region | string | One of US, EU. |
release_phoneChanges state
Hand a phone back to the pool. It leaves this workspace at once; its apps, data and device identity are erased before anyone can claim it again.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | Phone id. |
Apps
search_apps
Search the operator-curated catalog of apps this workspace can INSTALL. An empty catalog does not mean there is nothing to drive: send_order works on any app already present on a phone, whether or not it is listed here. Search with an empty query to list the whole catalog.
| Parameter | Type | Description |
|---|---|---|
queryrequired | string | Name or package fragment. Empty lists everything. |
get_app
Resolve one catalog app by exact Android package name.
| Parameter | Type | Description |
|---|---|---|
pkgrequired | string | Android package name. |
install_appChanges state
Install an app from the operator-curated catalog onto phones. Only catalog apps with a verified signing certificate can be installed; use search_apps to see what is available. Driving an app that is already on the phone needs no install. Returns immediately with an install run; poll get_run until it is done.
| Parameter | Type | Description |
|---|---|---|
pkgrequired | string | Android package name, e.g. com.example.app. |
phones | string[] | Phone ids. Omit for every ready phone. |
Skills
list_skills
List registered skills.
create_skillChanges state
Register a skill: a bounded natural-language workflow the vision agent runs inside one app.
| Parameter | Type | Description |
|---|---|---|
namerequired | string | |
apprequired | string | Android package the skill drives, e.g. com.example.app. Must already be installed on the target phones; it need not be in the install catalog. |
intent | string | What the skill is for. |
workflowrequired | any[] | Blocks the agent executes in order: step {text}, wait {seconds}, repeat {times, body}, if {condition, then, else}. At most 64 blocks in total and 4 levels of nesting. |
guardrails | object | |
risk | string | One of low, medium, high. |
targetCohort | string | Default cohort name. |
set_skill_enabledChanges state
Enable or disable a registered skill.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | Skill id. |
enabledrequired | boolean |
delete_skillChanges state
Delete a registered skill.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | Skill id. |
Cohorts
list_cohorts
List cohorts: attribute groups used to target runs.
create_cohortChanges state
Create a cohort from region, model, and/or installed app.
| Parameter | Type | Description |
|---|---|---|
namerequired | string | |
filter | object |
delete_cohortChanges state
Delete a cohort.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | Cohort id. |
Runs
send_orderChanges state
Start a vision-agent run: opens the skill's app on the target phones and drives the screen until the workflow is done. The app is any package already installed on the phone; it does not have to be in the install catalog, so search_apps returning nothing does not block this. Give exactly one of skill_id or skill, and at most one of target or phones (neither means every ready phone). Returns immediately; poll get_run, and stop_job to abort.
| Parameter | Type | Description |
|---|---|---|
skill_id | string | Registered skill id. Exactly one of skill_id or skill. |
skill | object | Ad hoc skill definition. Exactly one of skill_id or skill. |
target | string | Cohort name. Not with phones. |
phones | string[] | Phone ids. Not with target. |
list_runs
List recent runs.
get_run
Inspect one run by id.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | Run id. |
stop_jobChanges state
Stop a queued or running run.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | Run id. |