rank_trackers_delete
V1 Rank Trackers Delete
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tracker_id | No |
V1 Rank Trackers Delete
| Name | Required | Description | Default |
|---|---|---|---|
| tracker_id | No |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It does not state that deletion is destructive, irreversible, or that it may affect historical results. The word 'Delete' implies mutation, but the description does not disclose side effects, permissions, or whether the operation is permanent. This is a significant gap for a destructive operation.
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?
The description is extremely short, but this is under-specification rather than effective conciseness. It provides no useful information beyond the tool name and version marker. A concise description should still convey purpose, usage, and behavior; this one does not.
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 destructive tool with no annotations, no output schema, and a single undocumented parameter, the description is completely inadequate. An agent has no way to know what the tool does, what the parameter means, what happens after deletion, or how to recover from a mistake. The sibling tools do not help because the description does not reference them.
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%, and the description does not explain the tracker_id parameter beyond its name. The schema shows tracker_id is an integer with a default of null, but it does not say what it identifies or how to obtain it. The description adds no meaning to the parameter, so an agent cannot confidently determine what value to pass.
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 'V1 Rank Trackers Delete' is a terse label rather than a functional description. It names the resource (rank trackers) and implies a delete operation, but it does not state what the tool actually does, what a rank tracker is, or what the consequences of deletion are. It is barely more than a restatement of the tool name, so it fails to distinguish itself meaningfully from siblings like rank_trackers_create or rank_trackers_list.
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 guidance on when to use this tool versus alternatives. The description does not mention prerequisites, such as needing an existing tracker_id, nor does it explain when deletion is appropriate. An agent would have to infer from the name that this tool deletes a rank tracker, and there is no indication of when to prefer it over other rank_tracker operations.
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.