Rename a watchlist
renameWatchlistRename one of your watchlists. The blacklist cannot be renamed. Paid plans only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The new name. | |
| listId | Yes | The list id from listWatchlists. |
renameWatchlistRename one of your watchlists. The blacklist cannot be renamed. Paid plans only.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The new name. | |
| listId | Yes | The list id from listWatchlists. |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=false, destructiveHint=false, and openWorldHint=false, so the safety profile is covered. The description adds value beyond them by disclosing the blacklist exclusion and the paid-plan requirement, which are constraints not visible anywhere in the schema or annotations. It does not say whether the prior name is recoverable, but rename is a low-risk mutation already flagged non-destructive.
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?
Three short sentences, front-loaded with the action, followed by the two constraints. Every sentence carries information an agent would otherwise have to discover the hard way, and nothing is redundant.
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 two-parameter mutation with full schema coverage, existing annotations, and no output schema, the description covers the action plus both hard constraints. Only the reversibility of the name change is left unstated, which is minor against the otherwise complete 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?
Schema description coverage is 100%, with both parameters documented including the max length and the pointer to listWatchlists for listId. The description adds no further detail about parameter semantics, so the baseline 3 applies.
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 and resource ('Rename one of your watchlists'), which is unambiguous and distinguishable from siblings such as createWatchlist, deleteWatchlist, and addToWatchlist. It does not explicitly name a sibling alternative, so it stops short of a 5.
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?
Gives concrete eligibility conditions for use: the blacklist cannot be renamed, and it is available on paid plans only. These are exactly the preconditions an agent needs before calling, though no alternative tool is named for cases when the call is not permitted.
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.