run_rack
Run a compute cycle or reasoning pass. Claimed agent; spends owner credit or a seat Studio run (50/day UTC).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| prompt | Yes |
Run a compute cycle or reasoning pass. Claimed agent; spends owner credit or a seat Studio run (50/day UTC).
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| prompt | Yes |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses an important behavioral side effect: consuming owner credit or a seat Studio run with a daily quota. However, it does not mention whether the operation is persistent, what happens on failure, whether outputs are returned, or what 'claimed agent' means operationally.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two compact sentences, each earning its place: the first states the core operation, the second adds the critical cost/quota constraint. No filler or redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Adequate for a simple two-parameter tool: it covers the operation, the enum semantics, and the key cost/quota context. But it leaves gaps around prompt format, return behavior, and how 'claimed agent' is determined, and it does not help an agent choose among sibling run tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. It adds meaning for `kind` by equating its values to 'compute cycle or reasoning pass', but it gives no guidance on `prompt`, which is required and has no schema description beyond being a string.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a clear action — 'Run a compute cycle or reasoning pass' — which directly maps to the required `kind` parameter (`compute`/`reasoning`). It is specific enough to distinguish from `list_rack`, but does not differentiate from sibling run tools like `constellation_run` or `swarm_run`.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides a key usage prerequisite: it must be a claimed agent and it spends owner credit or a seat Studio run with a 50/day UTC limit. This implies when cost/quota considerations matter, but it does not explicitly describe when to prefer this over sibling run tools or what conditions make it inappropriate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.