Title99/100
Create Cloud Computer
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
Create a persistent Cloud computer. Use a new key per computer and reuse it on retries. Ask the user which size_id to use before calling; without one the call is refused and lists the sizes available on this account. Returns name (the created or reused computer id), provider, and state after the computer reaches running. Use that name in subsequent computer tools.
The description explains the capability, when to use it, and what to expect.
Inputs94/100
Input documentation gives an agent enough context to populate the arguments.
idempotency_key
Client-chosen identity for this creation. Reuse it with the same size and template on retries; use a new key for another computer.
Clear enough to supply this argument.
size_id
User-chosen CPU and RAM allocation for the new computer. Availability depends on the account's plan.
Clear enough to supply this argument.
template_id
What the computer starts with. Defaults to scratch, a bare Ubuntu without Python or Node.js. coding-agent adds Python, Node.js, Git and common build tools.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Output schema86/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"required": [
"name",
"provider",
"state"
],
"properties": {
"name": {
"type": "string",
"description": "Id of the created (or idempotently reused) computer."
},
"state": {
"type": "string",
"description": "Lifecycle state after the operation (running, stopped, or deleted)."
},
"provider": {
"type": "string",
"description": "Always cloud for hosted computers."
}
}
}