Stop watching a road
unwatch_roadDelete a watch by id.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |
unwatch_roadDelete a watch by id.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare destructiveHint=true, idempotentHint=true and readOnlyHint=false, so the safety profile is covered structurally. The description adds nothing beyond that structured data — it does not say whether deletion is immediate or reversible, whether a non-existent id errors or is silently ignored (relevant despite idempotency), or whether any notification/confirmation follows.
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, front-loaded sentence with no filler. It is efficient but borders on under-specification rather than being genuinely concise, since the single clause is all the information provided.
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?
This is a destructive mutation with no output schema, no parameter documentation, and no usage context. The description should at minimum identify the source of the id and confirm the deletion's effect; neither is present, so an agent cannot call it confidently without inspecting sibling schemas.
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% for the single required parameter, so the description carries the burden and only offers "by id". It never clarifies whether this id is a watch identifier (from list_watches) or a road identifier as watch_road likely takes, which is a meaningful distinction against the sibling tools.
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?
The description gives a specific verb and resource ("Delete a watch") plus the keying parameter ("by id"), which is more than the bare title repeats. However, it never distinguishes the operation from the sibling watch_road (its inverse) or list_watches, and it shifts vocabulary from "road" in the tool name/title to "watch" here, leaving the agent to infer the relationship.
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 at all: no mention of how a watch id is obtained (presumably from list_watches), no note that this is the inverse of watch_road, and no statement about what happens if the id does not exist. The agent must infer the entire workflow from sibling names.
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.