Skip to main content
Glama

inspect_watch

Read a saved watch, its coverage and source health. This does not check sources or acknowledge changes.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.5/5.0
Behavior3/5

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 that this is a read-only inspection and explicitly that it neither checks sources nor acknowledges changes, which is useful scope-limiting context. It says nothing about permissions, return shape, or whether the read has side effects beyond the exclusions, leaving clear gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tight sentences with zero filler. The positive scope is front-loaded and the boundary constraints follow immediately, so every clause earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-param read tool with no output schema and no annotations, the minimum viable information is present: purpose and negative scope. It does not explain what 'coverage and source health' actually contains nor what the id refers to, so an agent can pick it but not fully anticipate results.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is one parameter (id) with 0% schema description coverage, so the description is the only place meaning could be added. It never mentions the id at all, leaving the sole input undefined in both schema and prose. With a real param and no compensating text, the zero-param baseline of 4 does not apply.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (Read) and resource (a saved watch) plus the two things surfaced: coverage and source health. It is distinguishable from siblings like check_coverage and acknowledge_changes, which are called out by exclusion. Not a tautology, though it never defines what a 'watch' is.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The closing sentence routes the agent away from adjacent tools: it does not check sources (use check_coverage) and does not acknowledge changes (use acknowledge_changes). That is implicit when-not guidance with named alternatives, though the positive condition for choosing this tool is only implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources