list_devices

Lists every Android device registered to your account, with online/offline status and which one is the default. Call this first in any workflow - it confirms your credentials work and shows what you can target. Read-only: it never changes device state.

Parameters

None.

Response

string

The AGI account the connection is authenticated as.

array

Registered devices. Each entry includes:

Show device fields

string

Unique device identifier - pass it to tools that take device_id.

string

Human-readable device name.

string

Manufacturer model identifier.

string

online or offline.

boolean

Whether the device is currently rejecting new tasks. See phone_device_pause.

boolean

Whether this device is used when calls omit device_id.

string

ISO timestamp of the device’s last contact with the server.

Example

{
  "account_email": "you@example.com",
  "devices": [
    {
      "device_id": "5b6dc94d-615c-461c-b829-c5839b6986e8",
      "device_name": "samsung SM-S731U1",
      "device_model": "SM-S731U1",
      "status": "online",
      "paused": false,
      "is_default": true,
      "last_seen": "2026-08-04T00:49:41Z"
    }
  ]
}

Notes

With no Android device registered, list_devices and set_default_device are the only tools the server exposes. Install the AGI Android app, sign in, and reconnect your MCP client to see the full tool list.
If you have multiple devices, call set_default_device once so later calls can omit device_id.

set_default_device - choose the fallback device
phone_device_status - deeper status for one device
phone_get_state - full live device snapshot

Getting Started

Devices

Sessions

Tasks

Parameters

Response

Example

Notes

​Parameters

​Response

​Example

​Notes

​Related

Parameters

Response

Example

Notes

Related