Skip to main content
Start from the symptom, land on the fix.

​
Quick index

​
The 60-second triage

1

Can you list devices?

Ask your assistant to call list_devices. If the call itself fails, the problem is authentication or the client connection.
2

Is the device online and unpaused?

If list_devices works but the device is missing, offline, or paused, it’s a device problem.
3

What does the task itself say?

If devices look healthy, check the task with phone_task_status: its status, terminal, and error almost always name the issue - the terminal outcomes table has the move for each.

​
Know your error layer

Errors surface at three layers, and each debugs differently:
  • HTTP (401 + WWW-Authenticate) - credentials never reached MCP → Authentication
  • JSON-RPC (error.data.reason like device_paused, task_not_found) - the tool call was rejected → fix the call
  • Task (terminal + task error object) - the task ran and ended → Error handling

​
Still stuck?

Email Support

support@theagi.company - include the tool call, the full error, and the task_id if you have one