Stop an autopilot
stop_autopilotStop an autopilot's schedule.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| autopilot_id | Yes | Autopilot id |
stop_autopilotStop an autopilot's schedule.
| Name | Required | Description | Default |
|---|---|---|---|
| autopilot_id | Yes | Autopilot id |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=false, idempotentHint=true, destructiveHint=false and openWorldHint=true, covering the safety profile. The description adds only a restatement of the name plus a thin 'schedule' scope hint; it says nothing about what happens to the autopilot or its positions after stopping, or whether it can be restarted.
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?
One short sentence, front-loaded with the action, no filler or redundancy. It is efficient, though arguably terse enough that the scope of 'schedule' is left slightly ambiguous.
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?
For a simple one-parameter mutation tool with annotations carrying the safety profile and no output schema, the description is minimally adequate. It still omits any indication of side effects (e.g., whether an in-flight run is interrupted) that would complete the picture.
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?
Single required parameter with 100% schema description coverage, so the schema already documents autopilot_id fully. The description adds no format or identity detail beyond what the schema provides, which is the baseline expectation at full coverage.
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 specific verb ('stop') and resource ('an autopilot's schedule'), and the word 'schedule' subtly scopes the action as distinct from deleting the autopilot (autopilots_delete). However, it never explicitly names or contrasts with the obvious sibling alternatives, so an agent must infer the boundary itself.
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?
There is no when-to-use guidance, no prerequisite conditions, and no mention of alternatives such as autopilots_delete or autopilot_action. Usage can only be inferred from the tool name.
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.