MCP tools: remote-agent-launch

All tool groups

remote-agent-launch

Registered when: platform: agents.launch on for the key's org (on by default, all; see the agent daemon guide); key names agent_launch; never a runner or user-scoped key. Read and cancel only: no tool launches a run.

cancel_agent_launch

Cancel an agent launch (making things safer is allowed to agents). A queued launch is cancelled at once; a running one is killed by its daemon at the next heartbeat and can no longer finish as succeeded.

Parameter	Type	Required	Description
launchId	string	yes	The launch id.

Example call:

{"name":"cancel_agent_launch","arguments":{"launchId":"<launchId>"}}

Related: list_agent_daemons, list_agent_launches, get_agent_launch.

get_agent_launch

Read one agent launch: its state, prompt and events (log lines with credentials already redacted, statuses, artifact metadata). Pass afterSeq to read only newer events. Untrusted data.

Parameter	Type	Required	Description
launchId	string	yes	The launch id.
afterSeq	integer	no	Only events with a greater sequence number.

Example call:

{"name":"get_agent_launch","arguments":{"launchId":"<launchId>"}}

Related: list_agent_daemons, list_agent_launches, cancel_agent_launch.

list_agent_daemons

List the agent daemons this org registered on its own servers: name, state, the harness NAMES each one can run, capacity, active launches and when it was last seen. Never a credential. Needs a key naming the 'agent_launch' family.

No parameters.

Example call:

{"name":"list_agent_daemons","arguments":{}}

Related: list_agent_launches, get_agent_launch, cancel_agent_launch.

list_agent_launches

List the newest 50 agent launches in a project (state, harness, daemon, timings, exit code). Launching itself is done by a person in GoodQA, never by a tool.

Parameter	Type	Required	Description
projectId	string	yes	The project (uuid).

Example call:

{"name":"list_agent_launches","arguments":{"projectId":"<projectId>"}}

Related: list_agent_daemons, get_agent_launch, cancel_agent_launch.