Agents & Machines
listAgentSessions
List Agent Sessions
List your agent sessions on the live roster: every agent currently queued, running or PARKED across your machines, PLUS any lane DROPPED or LOST (its machine restarted mid-run) in the last 24 hours:…
Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "what are my agents doing", and it calls listAgentSessions.
Example call
The MCP tools/call params, with the required arguments only.
{
"arguments": {},
"name": "listAgentSessions"
}Arguments
rolestringoptionalKeep only runs whose provenance role contains this (case-insensitive), e.g. "guide" for GUIDE-tier runs, "Ora" for all Ora-signed runs. Omit to list every role.statestringoptionalKeep only runs in this state. "running" is work actually happening; "parked" is a lane its box is holding on a seat limit: alive, holding a checkout, doing nothing. "dropped" is the one to reach for after a bad night: the lanes that never…tagstringoptionalKeep only runs carrying this tag (a leading # is stripped, matched normalized). Omit to list every run on the roster.
Returns
The registry does not declare a return shape.
Ask for it
The Cloud routes these requests to this verb.
- what are my agents doing
- list running agents
- show my agents
- what's running
- why is nothing moving
- are we rate limited
- which lanes are parked
- which lanes went quiet
- which lanes were dropped
- did anything die overnight
- which guide runs are live
- runs tagged #X
Pair it with
The verbs that finish the job.
Questions
What does listAgentSessions do?
List your agent sessions on the live roster: every agent currently queued, running or PARKED across your machines, PLUS any lane DROPPED or LOST (its machine restarted mid-run) in the last 24 hours:… It is one of the tools The Cloud MCP server gives every connected AI.
How do I use listAgentSessions from Claude or ChatGPT?
Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "what are my agents doing", and it calls listAgentSessions.
Is listAgentSessions safe to let an AI call?
listAgentSessions is read-only: it changes nothing.
Connect
One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.