> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agi.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# list_devices

> List your registered devices with online status and the current default.

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

<ResponseField name="account_email" type="string">
  The AGI account the connection is authenticated as.
</ResponseField>

<ResponseField name="devices" type="array">
  Registered devices. Each entry includes:

  <Expandable title="device fields">
    <ResponseField name="device_id" type="string">
      Unique device identifier - pass it to tools that take `device_id`.
    </ResponseField>

    <ResponseField name="device_name" type="string">
      Human-readable device name.
    </ResponseField>

    <ResponseField name="device_model" type="string">
      Manufacturer model identifier.
    </ResponseField>

    <ResponseField name="status" type="string">
      `online` or `offline`.
    </ResponseField>

    <ResponseField name="paused" type="boolean">
      Whether the device is currently rejecting new tasks. See
      [`phone_device_pause`](/api-reference/tools/phone-device-pause).
    </ResponseField>

    <ResponseField name="is_default" type="boolean">
      Whether this device is used when calls omit `device_id`.
    </ResponseField>

    <ResponseField name="last_seen" type="string">
      ISO timestamp of the device's last contact with the server.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```json theme={null}
{
  "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`](/api-reference/tools/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`.

## Related

* [`set_default_device`](/api-reference/tools/set-default-device) - choose the fallback device
* [`phone_device_status`](/api-reference/tools/phone-device-status) - deeper status for one device
* [`phone_get_state`](/api-reference/tools/phone-get-state) - full live device snapshot