Skip to main content
Glama

Pacific/Tongatapu clock

Server Details

Current local time in Pacific/Tongatapu.

If you are the author of this connector, you can claim ownership with GitHub, an HTTP challenge, or a DNS record. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
sadri-dridi/named-mcp-utilities
GitHub Stars
0

TDQS

C2.4/5.0

Scored across 28 tools

Disambiguation1/5

Several tools are effectively indistinguishable: browser-url-ok and playwright-url-ok have identical descriptions, and fetch-status, web-fetch, citation, and lib-docs-hint all overlap on checking URL/HTTP status. An agent cannot reliably choose between them.

Naming Consistency3/5

Most names are lowercase hyphenated and some useful suffixes emerge (-ok, -shape, -hint), but the conventions are mixed: nouns like citation and timezone sit alongside verbs like validate-json and web-fetch. The parallel browser-url-ok / playwright-url-ok pair is also confusing.

Tool Count2/5

At 28 tools the count is above the 25 threshold, and the vast majority are unrelated to the clock/timezone purpose suggested by the server name. Only timezone, utc-time, and iana-zones clearly belong; the rest form a scattered utility grab bag.

Completeness2/5

The apparent clock domain is only minimally covered and lacks useful operations like timezone conversion, while the many URL and input-checking tools overlap without forming a coherent workflow. No clear domain is served completely.

Available Tools

28 tools
agent-tool-indexAInspect

Find a public pay-per-call tool gateway (Monid). Returns CLI setup, how-it-works, skill file, and remote MCP hops. Task text discarded.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no meaningful annotations provided, the description carries the burden of behavioral disclosure. It discloses that 'Task text discarded', which is a useful privacy/behavioral trait, and it clarifies expected outputs. It does not mention potential network costs or authentication, but the read-oriented 'Find/Returns' framing makes the behavior reasonably clear.

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?

The description is three short, purposeful sentences. The main action is front-loaded, the return values are compactly listed, and the task-text-discarded note is placed at the end. Every sentence earns its place.

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

Completeness4/5

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

There is no output schema, but the description lists the key returned artifacts (CLI setup, how-it-works, skill file, remote MCP hops). It also reassures about task-text handling. It could add more context about what 'Monid' is or that all parameters are effectively ignored, but the schema descriptions already cover the discarded-parameter behavior.

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

Parameters3/5

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

The input schema already provides 100% description coverage for all seven parameters, each explicitly stating that the value is discarded after a shape check or validation. The tool description adds no parameter-level meaning beyond what the schema already provides, so the baseline of 3 applies.

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?

The description states a specific verb and resource: 'Find a public pay-per-call tool gateway (Monid)', and lists the concrete return values (CLI setup, how-it-works, skill file, remote MCP hops). It is clear and specific, but it does not explicitly distinguish itself from sibling tools like web-fetch or normalize-url.

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

Usage Guidelines3/5

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

The use case is implied: the tool is for finding the Monid gateway and retrieving its setup/hop information. However, there is no explicit guidance about when to choose this tool over alternatives, nor any stated context or exclusions.

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

browser-url-okBInspect

Check whether a URL can be opened. No browser is launched.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnlyHint, idempotentHint, destructiveHint), so the bar is lower. The description adds 'No browser is launched,' a genuinely useful behavioral trait not present in annotations. However, it doesn't describe other behaviors like whether the tool performs network calls or what the result format looks like, so it remains at a moderate level.

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?

The description is exactly two short sentences with no filler. The purpose is front-loaded, and the caveat about not launching a browser is placed second. Every word earns its place.

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

Completeness2/5

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

The schema exposes eight parameters, many marked as 'discarded after the shape check,' suggesting the tool serves a broader shape-validation role than the URL-only description implies. There is no output schema, and the description doesn't clarify whether only the 'url' parameter is used or whether multiple parameters can be passed, nor what the return value indicates. This ambiguity leaves the invocation unclear despite the rich schema.

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

Parameters3/5

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

The input schema provides detailed descriptions for every parameter (e.g., 'Git ref name; discarded after the shape check', 'HTTPS URL to normalize or cite'), giving high schema_description_coverage. The description itself adds no parameter-specific meaning beyond confirming the 'url' property is central, so the baseline of 3 is appropriate.

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?

The description clearly states a specific verb ('Check') and resource ('URL') with an outcome ('can be opened'). The second sentence, 'No browser is launched,' adds a distinguishing detail that separates it from browser-launching alternatives like playwright-url-ok, but it doesn't explicitly name or differentiate from sibling tools such as web-fetch or fetch-status.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool compared to alternatives. It mentions 'No browser is launched,' which hints at a lightweight or non-visual check, but there is no explicit statement of when to choose this over other URL-related tools or any exclusionary conditions.

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

calc-evalCInspect

Evaluate a+b style arithmetic. Expression discarded.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must carry the behavioral disclosure burden. The phrase 'Expression discarded' gives a minimal side-effect hint, but it does not state whether a result is returned, what happens on invalid input, or how the seven unrelated schema fields are used.

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

Conciseness4/5

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

The description is very short and front-loads the primary action, with no filler. 'Expression discarded' is ambiguous and perhaps wasted wording, but overall the placement and brevity are acceptable.

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

Completeness1/5

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

For a tool with seven parameters and no output schema, this description is severely incomplete. It fails to connect any parameter to the described behavior, and it does not explain return values, error behavior, or which of the many fields, if any, should be provided. An agent cannot safely select or invoke this tool.

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?

Each schema property has a description, but none of them describe operands or an expression matching 'a+b style arithmetic'. The description adds no mapping between the stated purpose and any parameter, so an agent cannot know which field to populate, making the high schema coverage unhelpful.

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

Purpose3/5

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

The description states a specific operation, 'Evaluate a+b style arithmetic', which nominally distinguishes it from the sibling validation/fetch tools. However, it is under-specified and confusing: 'Expression discarded' is unclear, and no schema property corresponds to an arithmetic expression, so the stated purpose cannot be mapped to an invocation.

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

Usage Guidelines2/5

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, no prerequisites, and no mention of when not to use it. The only implied usage is the terse 'Evaluate a+b style arithmetic', which is not enough to select this tool correctly among the many sibling tools.

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

citationBInspect

Return host, scheme, and HTTP status for a URL. Page content is not stored.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry behavioral disclosure, and it does add one useful privacy-related trait: 'Page content is not stored.' It also implies a read-only status check by saying 'Return.' However, it does not disclose error behavior, side effects, or whether input parameters are actually discarded; the schema's 'discarded' notes are not repeated in the description.

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

Conciseness4/5

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

The description is short, front-loaded with the primary behavior, and contains no filler. The second sentence earns its place as a privacy note, but the overall terseness feels thin relative to the nine-parameter schema, so it stops short of a 5.

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

Completeness2/5

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

Given the nine optional parameters, no output schema, no annotations, and a crowded sibling list containing several URL-focused tools, this description is not complete enough. It does not specify the return format beyond three fields, which parameters to use, how to handle the optional extras, or how this differs from fetch-status and normalize-url.

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

Parameters3/5

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

Schema description coverage is 100%, so the baseline is 3, and the description adds little beyond mentioning a URL. It does not explain how the other eight optional parameters relate to the tool, why they all exist, or which one should be supplied; the agent is left with a confusing schema.

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?

The description clearly states the tool returns host, scheme, and HTTP status for a URL, so the core action and resource are identifiable. However, the name 'citation' is not explained, and siblings like fetch-status, browser-url-ok, and normalize-url suggest overlapping URL-related purposes, so the description does not differentiate this tool from those.

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

Usage Guidelines2/5

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 the many URL-related siblings, nor any mention of when not to use it. The description only states what it returns, leaving the agent to guess whether this is the right tool for fetching status, checking URL shape, or something else.

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

compatibilityCInspect

Show how this request is classified. No identifiers are retained.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description discloses that identifiers are not retained, which is a useful privacy note, but it does not explain whether the tool makes network calls, accesses files, or performs any other side effects. With no annotations, the behavioral disclosure is incomplete.

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

Conciseness3/5

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

The description is brief and uses no unnecessary words, but it is too terse to be well-structured or informative. It reads as a single vague sentence rather than a properly organized tool description.

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

Completeness1/5

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

The tool has nine varied optional parameters, no output schema, and no annotations, yet the description provides almost no context about its purpose, classification logic, or expected behavior. It is not complete enough for an agent to know when or how to call it.

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

Parameters3/5

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

The schema already provides 100% description coverage for all nine parameters, each with a clear one-line meaning. The tool description adds no extra parameter semantics beyond the schema, so the baseline score of 3 is appropriate.

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

Purpose2/5

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

The description says the tool will 'Show how this request is classified,' but it never defines what 'compatibility' means, what classification categories exist, or what the output will look like. The purpose is too vague to distinguish from other tools, and the name alone does not clarify the behavior.

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

Usage Guidelines1/5

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 instead of one of the many siblings. It does not mention whether it should be used for routing, validation, or something else, nor does it indicate prerequisites or expected input patterns.

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

domain-shapeAInspect

Split a hostname into labels without WHOIS or ownership data.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations present, the description carries the burden of behavioral disclosure. It does disclose an important boundary: no WHOIS or ownership data. It does not mention normalization, network behavior, or the fact that most input schema fields are unrelated and discarded, which leaves some behavioral ambiguity for a no-annotation tool.

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?

The description is a single, sharply front-loaded sentence with no filler. It states the action, the resource, and the limitation without redundancy.

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

Completeness2/5

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

The input schema is broad and contains seven unrelated fields with no required marker, yet the description does not clarify that only 'host' matters or what the output shape looks like. There is also no output schema and no annotations, so a one-line description is insufficient to guarantee correct invocation. An agent inspecting the schema would have to guess which parameter is actually relevant.

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

Parameters3/5

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

The input schema has seven properties and all are described, so schema coverage is 100 percent and the baseline is 3. The description adds no parameter-level mapping, though 'hostname' reasonably points to the 'host' field. The unrelated extra fields make the parameter intent somewhat ambiguous, but the schema descriptions themselves are informative enough to avoid misinformation.

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

Purpose5/5

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

The description uses a specific verb and resource: 'Split a hostname into labels.' The added scope clause 'without WHOIS or ownership data' clearly distinguishes this from any ownership or lookup-oriented tool. It states exactly what the tool does in one focused sentence.

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

Usage Guidelines3/5

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

The intended use case is implied: use this when you need hostname labels rather than ownership information. However, the description never names alternatives or gives explicit conditions for choosing this over sibling tools like normalize-url, web-fetch, or the other shape tools. It provides a partial exclusion but no real routing guidance.

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

fetch-statusAInspect

HEAD a public URL and return status only.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries transparency alone and does disclose the HTTP method (HEAD), that the target must be public, and that the response is limited to status. It does not mention redirects, timeouts, or error behavior, but the core behavior is clear.

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?

One short, front-loaded sentence with no filler; every word contributes to the method, scope, and output constraint.

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?

The description is adequate for a simple HEAD status check, but the tool has nine optional parameters and no output schema. It does not state that parameters other than url are ignored, nor does it describe the shape of the returned status, so an agent may have to experiment.

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

Parameters3/5

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

Schema description coverage is 100%, so the baseline applies. The description does clarify that the URL parameter is the target of the HEAD check, but it does not explain why there are eight other optional fields or how they relate to status fetching, leaving some ambiguity.

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?

Description states a specific verb (HEAD), resource (public URL), and output scope (status only), making the core purpose unambiguous. It does not explicitly differentiate from sibling URL-checking tools, but the 'status only' qualifier already narrows it substantially.

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

Usage Guidelines3/5

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

The description implies a use case: checking whether a public URL is reachable and only needing its status. However, it gives no explicit when-to-use vs when-not-to-use guidance and does not name alternatives such as web-fetch, browser-url-ok, or playwright-url-ok.

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

figma-url-shapeBInspect

Parse a Figma file URL. Path discarded.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description is solely responsible for revealing behavior; it does disclose one behavior ('Path discarded') but does not explain what 'parse' returns, what validation criteria define a valid Figma URL, how failures are reported, or whether any network request occurs. That is some context, but far from sufficient.

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

Conciseness4/5

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

Two terse sentences with no filler; the main action is front-loaded. 'Path discarded' earns some place as a behavioral note, but its ambiguity prevents this from being an exemplary concise definition.

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

Completeness2/5

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

Given nine optional parameters, no annotations, no output schema, and a large family of sibling tools, a two-sentence description is not enough. It omits the required parameter mapping, return shape, validation semantics, and differentiation from other URL tools, so correct invocation is not reliably achievable.

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?

Schema coverage is 100%, but the description never names the relevant parameter, and none of the parameter descriptions mention Figma. The only plausible parameter, 'url', is described as 'HTTPS URL to normalize or cite,' which conflicts with the Figma-specific intent; with nine optional parameters, an agent cannot confidently determine what to pass.

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?

The description names a specific action ('Parse') and resource ('a Figma file URL'), so the core purpose is identifiable. It doesn't explicitly distinguish this from sibling URL/shape tools such as normalize-url or browser-url-ok, and 'Path discarded' is ambiguous enough to blur the exact scope.

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

Usage Guidelines3/5

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

The wording implies the tool is appropriate when an agent encounters a Figma file URL, which gives weak usage context. It provides no when-not-to-use guidance or comparison to alternatives, so an agent must infer the boundary with sibling tools.

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

file-path-okBInspect

Check whether a path looks safe. No disk access.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

There are no annotations, so the description carries the full burden. It does disclose an important behavioral trait: 'No disk access,' which tells the agent this is not an actual filesystem check. However, it does not explain what 'looks safe' means, whether it returns a boolean or throws, or what happens on invalid input.

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?

The description is two short sentences with no filler. 'Check whether a path looks safe' states the purpose, and 'No disk access' adds needed scope. Every word earns its place.

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

Completeness2/5

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

The tool is simple in intent but has a noisy schema with seven parameters, no annotations, and no output schema. The description does not clarify which parameter(s) to use, what the return value looks like, or why the unrelated parameters are present. An agent could easily pass the wrong parameter or expect disk-level validation.

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

Parameters3/5

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

All parameters in the schema have descriptions, so schema coverage is high and the baseline is 3. The description references 'a path' and matches the `path` parameter description, but it adds no additional parameter-level meaning. It also fails to clarify that the other six schema parameters appear unrelated to a file-path check, leaving ambiguity.

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?

The description states a specific verb and resource: 'Check whether a path looks safe.' It also adds a meaningful qualifier, 'No disk access,' which clarifies the scope. It does not explicitly name sibling tools to distinguish from, but the path-focused wording separates it from URL-oriented siblings like browser-url-ok and playwright-url-ok.

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

Usage Guidelines2/5

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

The description gives no guidance about when to use this tool versus alternatives. 'No disk access' implies it is a lightweight shape check rather than a filesystem operation, but it does not state exclusions, prerequisites, or when another sibling should be chosen. The agent must infer usage from the name and description alone.

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

geo-hintCInspect

Latitude and longitude for a place via Open-Meteo.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full behavioral disclosure burden. It mentions Open-Meteo but does not describe whether the call is read-only, what happens on unknown places, whether any values are retained, or why the schema parameters are marked 'discarded.'

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

Conciseness4/5

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

The description is one short, front-loaded sentence with no filler; it conveys the core function efficiently. It loses point only because brevity comes at the expense of operational detail.

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

Completeness2/5

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

With seven parameters, no annotations, no output schema, and a large sibling-tool set, the description is not complete enough for correct invocation. It fails to state the required input, the expected output shape, or how geo-hint is meant to be selected over related tools.

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?

The input schema has seven richly described parameters, but the description does not connect 'a place' to the city parameter. Most parameters appear unrelated to latitude/longitude and are explicitly marked as discarded, while city is also marked 'discarded after the call,' making it ambiguous which parameter actually drives the tool.

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?

The description states a clear output (latitude and longitude) and source service (Open-Meteo) for a place, so an agent can grasp the high-level function. However, it does not specify which input parameter identifies the place, and it does not differentiate the tool from sibling weather-hint or timezone tools.

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

Usage Guidelines2/5

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

There is no guidance about when to use geo-hint versus alternatives, no stated prerequisites, and no examples. The single sentence only describes what the tool does, leaving the agent to infer selection criteria without support.

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

github-repo-shapeAInspect

Parse owner and repo from a GitHub URL.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

A3.7/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 of behavioral disclosure. It does state the core behavior—parsing owner and repo from a URL—but it does not mention validation, error handling, or the fact that irrelevant inputs are discarded, though some of that is hinted at in the schema.

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?

The description is one short sentence with no filler. It front-loads the key action and resource and every word contributes to understanding the tool's purpose.

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 simple parse operation, stating that it extracts owner and repo is useful, but there is no output schema and no explanation of invalid URL behavior or why the schema contains many seemingly unrelated parameters. It is adequate for a very simple tool but leaves clear gaps around edge cases and expected output shape.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already explains each parameter individually. The description adds little parameter-level meaning beyond implying that the URL should be a GitHub URL, but it does not clarify which parameter is the intended GitHub URL or how the other six parameters relate.

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

Purpose5/5

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

The description uses a specific verb ('Parse') and a specific resource ('owner and repo from a GitHub URL'), making the tool's core function immediately obvious. It also distinguishes itself from sibling shape tools by scoping to GitHub URLs.

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

Usage Guidelines3/5

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

The phrase 'from a GitHub URL' implies this tool is meant for GitHub repository links, which is helpful context. However, it gives no explicit guidance about when not to use it or how it compares to sibling tools like domain-shape or jira-key-shape, leaving the agent to infer routing.

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

hn-front-countAInspect

Count current Hacker News front-page stories. Titles discarded.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the behavioral burden; it does disclose that the operation is a live count and that titles are omitted from the result. It does not describe return format, failure modes, or whether any of the nine optional parameters affect the count, so transparency is partial.

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

Conciseness4/5

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

Two short sentences front-load the exact purpose and add one clarifying output detail. There is no filler, though the clipped phrase 'Titles discarded' could be slightly more explicit (e.g., 'returns only the count').

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

Completeness2/5

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

Despite having no output schema and no annotations, the description does not specify what the count looks like, how errors surface, or how the nine optional params relate to the operation. The definition is adequate only for the simplest no-argument call and could mislead an agent into passing unrelated parameters.

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

Parameters3/5

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

Schema coverage is 100%, so the parameter descriptions already document each field and the description need not repeat them. Yet the description adds no guidance about which parameters, if any, are useful for the HN count, and several schema descriptions are unrelated to the tool's purpose.

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

Purpose5/5

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

The description names a concrete action ('Count') and a precise resource ('current Hacker News front-page stories'), and adds the behavioral note that titles are discarded. This makes the tool's purpose unmistakable and distinguishes it from sibling fetch/validation tools.

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

Usage Guidelines3/5

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

The tool's purpose implies when to call it: whenever a count of the current HN front page is needed. However, it does not explicitly state when not to use it or mention alternatives such as web-fetch or fetch-status, leaving the comparative guidance to inference.

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

iana-zonesCInspect

Common IANA timezone names for clock calls.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2.1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description must carry the full behavioral burden. It fails to state whether the tool is read-only, what it returns, whether it has side effects, or how values are handled. The noun-phrase description does not disclose any observable behavior.

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

Conciseness2/5

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

The text is short and front-loaded, but it is under-specified rather than usefully concise. A single noun phrase omits essential operational details, so brevity is not an asset here.

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

Completeness1/5

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

With seven parameters, no output schema, no annotations, and many related sibling tools, this one-line description is far from sufficient. An agent cannot determine the expected input, output, or relationship to timezone-related sibling tools.

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

Parameters3/5

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

All seven parameters already have schema descriptions, including notes that values are discarded or used for shape checks, so schema coverage is high. The description itself adds no parameter meaning, but per the coverage baseline this is acceptable; it neither clarifies nor contradicts the schema.

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

Purpose3/5

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

The description identifies a resource ('Common IANA timezone names') and a context ('for clock calls'), but lacks a verb and does not say whether the tool returns, validates, or otherwise processes those names. It is not a pure tautology, but an agent cannot confidently tell what action the tool performs.

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

Usage Guidelines2/5

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

The phrase 'for clock calls' weakly implies a use case, but there is no explicit when-to-use guidance, no mention of alternatives, and no exclusions. Given siblings like timezone and utc-time, the description provides no help in choosing among related tools.

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

inspect-robotsBInspect

Fetch a public robots.txt and return group counts only.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden. It does disclose that the tool makes a public network fetch and returns only group counts, which implies a read-only, limited operation. However, it omits failure behavior, error handling, redirects, or what happens when robots.txt is missing.

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?

The description is a single, front-loaded sentence with no filler. Every word contributes to understanding the core action and output restriction.

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

Completeness2/5

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

The tool has seven parameters and no output schema, yet the description does not identify which parameter to use, what the return structure looks like, or any edge cases. An agent invoking this tool would be uncertain whether to pass 'url', 'host', or 'path', making the definition incomplete for correct invocation.

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

Parameters3/5

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

Schema description coverage is 100%, so the baseline is 3. The tool description adds no parameter-specific meaning, and the schema's generic descriptions for fields like 'url' and 'host' do not clarify which parameter actually selects the robots.txt source. The description neither compensates for nor contradicts the schema.

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?

The description clearly states a specific action (fetch a public robots.txt) and a specific output (group counts only). It is a clear and unambiguous statement of purpose, though it does not explicitly differentiate this tool from siblings such as fetch-status or web-fetch.

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

Usage Guidelines2/5

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

No guidance is given for when to use this tool versus alternatives. The phrase 'group counts only' implies a narrow use case, but there is no explicit exclusion or mention of sibling tools, so an agent must infer when this is the right choice.

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

jira-key-shapeCInspect

Check a Jira issue key shape. Key discarded.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description notes that the key is discarded, which is a useful side-effect disclosure, but no annotations are provided and the description does not clarify return values, error behavior, or whether validation happens locally. It also creates confusion because the schema has unrelated parameters, making the actual behavior of the tool unclear.

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

Conciseness3/5

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

The description is very short and front-loaded with the core purpose, which is a positive trait. However, the terse two-sentence format underdelivers for a tool with seven diverse parameters and no annotations, so the structure is not helpful enough for autonomous selection.

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

Completeness1/5

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

There are no annotations and no output schema, and the description is only two sentences that reference a non-existent key parameter. With seven unrelated schema properties, an agent cannot tell which field to fill, what the tool returns, or what side effects occur beyond the vague 'discarded' note, making the definition operationally incomplete.

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?

The schema provides descriptions for all seven parameters, so the schema coverage is high, but the tool description does not explain how any parameter maps to a 'Jira issue key'. The central input concept from the tool name and description is completely absent from the input schema, meaning the description adds no useful semantic link for parameter selection.

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?

The description clearly states the tool checks a Jira issue key shape, which is a specific verb and resource and distinguishes it from sibling shape tools like github-repo-shape and figma-url-shape. However, the input schema contains no property called 'key', so the operational target of the tool is unclear despite the stated purpose.

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

Usage Guidelines2/5

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

The description gives no guidance on when to use this tool versus alternatives, and no exclusions or prerequisites are mentioned. An agent must infer that it is for validating a Jira issue key format, but the description does not explicitly say that or warn against using other shape-checking tools.

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

lib-docs-hintCInspect

HTTP status for a public library docs URL. Body discarded.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full transparency burden. It does disclose that the body is discarded, which meaningfully tells the caller not to expect content. However, it does not mention network behavior, redirects, timeouts, error handling, or whether the operation is strictly read-only, leaving some important behavior undisclosed.

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

Conciseness4/5

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

The description is two short sentences with the main purpose front-loaded and no filler. 'Body discarded' earns its place by clarifying the output behavior. However, given the tool's nine optional parameters, the description is perhaps slightly too terse and could have used an added sentence on the relevant parameter.

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

Completeness2/5

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

The tool has nine optional parameters, no output schema, and no annotations, so the description must compensate. It does not indicate which parameter is used, what the response format looks like, what 'hint' means in this context, or how this relates to the many sibling tools. The definition is incomplete for an agent to confidently select and invoke this tool correctly.

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?

Although schema description coverage is 100%, many parameter descriptions seem mismatched with the tool's stated purpose: 'city' references a weather hint, 'zone' is a timezone, 'json' is for validation, and 'query' is for a length check. The description does not explain which parameter to use for the HTTP status check, and the 'url' parameter is described as 'to normalize or cite' rather than to fetch a status. The schema therefore provides little coherent help for selecting the correct parameter.

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?

The description states a specific verb and resource: it returns the HTTP status for a public library docs URL. The added 'Body discarded' clarifies the scope of the result. It does not explicitly differentiate itself from sibling tools like fetch-status or web-fetch, but the 'public library docs URL' qualifier narrows the purpose.

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

Usage Guidelines2/5

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 instead of siblings such as fetch-status, browser-url-ok, web-fetch, or normalize-url. The description gives no context about prerequisites, preferred inputs, or exclusions. It is left entirely to the agent to infer the intended use case.

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

memory-key-countCInspect

Count keys in a JSON object. Values discarded.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry the behavioral disclosure burden, but it only says values are discarded. It does not disclose the return format, whether counting is top-level or recursive, how invalid input is handled, or which input field actually represents the JSON object.

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 short, front-loaded sentences with no filler. 'Values discarded' earns its place as a meaningful behavioral note.

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

Completeness2/5

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

For a tool with 9 optional parameters, no annotations, and no output schema, this is too thin. An agent cannot confidently determine what to send or what response to expect, especially given the unclear relationship between the 'JSON object' wording and the flat string-parameter schema.

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

Parameters3/5

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

The schema already documents all 9 parameters with individual descriptions, so the baseline is 3. The description adds no parameter-level meaning and leaves ambiguity around whether all supplied keys are counted or only the 'json' field is inspected.

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 operation: count keys in a JSON object, with values discarded. This is distinguishable from siblings like validate-json, but it does not clarify whether the 'JSON object' means the invocation payload itself or a JSON string passed via the 'json' parameter.

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

Usage Guidelines2/5

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

No guidance is given about when to use this tool over alternatives such as validate-json or the various shape-check tools. The scenario is only implied by the verb 'count', with no exclusions, prerequisites, or sibling comparisons.

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

normalize-urlBInspect

Return origin, host, and path for a URL. Query and fragment are dropped.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Without annotations, the description carries the behavioral disclosure burden. It flatly states that query and fragment are dropped, which is a useful behavioral detail. However, it says nothing about invalid URLs, scheme requirements, or whether any other inputs affect behavior, leaving some transparency 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 short, front-loaded sentences clearly state the core behavior and an important edge-case rule (dropping query and fragment). No filler or redundant wording.

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?

The description is adequate for a simple transform tool: it gives the return fields and states the main behavior. It lacks an explicit statement that `url` is the only meaningful input, and with no output schema or annotations, an agent gets no information about return format or error handling.

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

Parameters3/5

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

The input schema already describes all seven parameters, and the description adds no parameter-level meaning beyond pointing at a URL. With high schema_description_coverage, the baseline of 3 applies; the description does not clarify which parameter is primary or why 'path' and 'host' also appear as inputs/outputs.

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?

The description uses a specific verb and resource ('Return origin, host, and path for a URL') and names the exact outputs. It is clear and aligned with the tool name, but it does not explicitly differentiate it from sibling URL/shape tools such as browser-url-ok or domain-shape.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use normalize-url versus alternatives and no exclusions or prerequisites. The only implied use case is from the description itself, with no mention of sibling tools or context.

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

playwright-url-okBInspect

Check whether a URL can be opened. No browser is launched.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It discloses one useful fact ('No browser is launched'), but it does not say whether an HTTP request is made, what counts as 'ok', whether the URL is modified or cited, or what the tool returns. This is minimal disclosure, not adequate transparency.

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

Conciseness4/5

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

The description is two short sentences with the core action front-loaded and no filler. It is concise to a fault because it omits behavioral and output details, but the structure itself is efficient and an agent can parse the main point immediately.

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

Completeness2/5

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

The tool has nine optional parameters, no output schema, and no annotations, so an agent needs more context about what result to expect and which parameter to use. The description only gives the high-level check and omits return semantics, success criteria, and guidance on how the unrelated parameters relate to the URL check.

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

Parameters3/5

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

The input schema has 100% description coverage for all nine parameters, so the schema already documents each parameter. The description adds no parameter-level meaning and does not clarify which parameter is central to the URL check, but it does not need to compensate heavily given the high schema coverage.

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?

The description uses a specific verb and resource ('Check whether a URL can be opened') and adds a key differentiator ('No browser is launched'), which helps distinguish it from browser-url-ok. However, 'can be opened' is somewhat vague, and the schema's nine unrelated parameters suggest the actual tool scope may be broader than the description implies.

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

Usage Guidelines3/5

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

The phrase 'No browser is launched' implies a lightweight URL check, which is a clear context signal for choosing this tool over a browser-based alternative. But it does not explicitly name alternatives like browser-url-ok or fetch-status, nor does it state when not to use this tool.

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

search-query-lenCInspect

Count characters in a search query. Query discarded.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full transparency burden. It only says 'Query discarded,' hinting at no persistence, but does not disclose return format, errors, or side effects beyond discard.

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?

The description is very brief and front-loaded. Both sentences add value: the first states the core action, and the second clarifies that no query data is retained.

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

Completeness2/5

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

Given the nine-parameter schema and no output schema, the description is incomplete. It does not clarify which parameter to use, what the return value looks like, or how this tool fits into the broader set of sibling tools.

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?

Although schema description coverage is 100%, the descriptions of the other eight parameters are irrelevant to counting search-query characters and are not reconciled with the tool's purpose. Only the 'query' parameter has meaningful semantics, but the rest create confusion.

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?

The description clearly states the action ('Count characters') and the target ('a search query'), which matches the tool name. However, the schema includes many unrelated parameters, so some ambiguity remains about which input is actually used.

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

Usage Guidelines2/5

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

No guidance is given about when to use this tool versus sibling tools. The description does not mention alternatives, prerequisites, or conditions that would help an agent select this tool.

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

status-catalogDInspect

Short catalog of common HTTP status codes.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

D1.9/5.0
Behavior1/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 for behavioral disclosure. It reveals no side effects, return value, or operational behavior; the noun phrase 'short catalog' implies a read-only result but never states what happens when parameters are supplied. The schema's hints that many parameters are 'discarded' are not reflected in the tool description, leaving the behavior opaque.

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

Conciseness3/5

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

The description is a single short sentence with no wasted words, which is structurally concise. However, it is so terse that it skirts under-specification rather than effective communication; it conveys less than an agent needs to act confidently.

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

Completeness1/5

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

With no annotations, no output schema, and seven confusing parameters, this one-sentence description is far from complete. It does not tell the agent what the tool returns, whether any input affects the result, or how it relates to neighboring tools. The definition is inadequate for reliable selection and invocation.

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

Parameters3/5

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

The input schema documents all seven parameters with descriptions, and several explicitly state that the value is discarded or has no effect, which provides some invocation guidance. The tool description itself adds no parameter meaning and does not explain why these unrelated parameters exist for a status-code catalog. Baseline 3 applies because schema coverage is high, but the semantic mismatch prevents a higher score.

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

Purpose2/5

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

The description, 'Short catalog of common HTTP status codes', essentially restates the tool name without a clear verb or action. It identifies the resource (HTTP status codes) but not what an agent should do with the tool, and the schema's unrelated parameters further confuse the intended operation. It does not distinguish this tool from siblings like fetch-status or domain-shape.

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

Usage Guidelines2/5

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

There is no guidance about when to use this tool versus the sibling alternatives. The description mentions no conditions, exclusions, or alternative tools, so an agent cannot determine the appropriate context for invoking it.

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

think-stepsCInspect

Return a three-step thinking template. Prompt discarded.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full responsibility for disclosing behavior. 'Prompt discarded.' hints that inputs may be ignored, but it is vague and fails to mention the shape-checking behavior implied by the schema parameter descriptions. The description does not clarify whether the tool is read-only or has side effects, or what happens with the various input parameters.

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

Conciseness4/5

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

The description is extremely concise, containing only two short sentences. The main function is front-loaded in the first sentence, and the second sentence adds a behavioral note. It avoids unnecessary verbosity, though the brevity comes at the cost of missing important context.

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

Completeness2/5

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

The tool has seven distinct parameters and no annotations or output schema, yet the description provides almost no contextual information. It does not explain what the three-step template is, which parameter to use, when to call the tool, or what happens to the inputs beyond the cryptic 'Prompt discarded.' This is inadequate for an agent to reliably select and invoke the tool.

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

Parameters3/5

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

The schema provides descriptions for all seven parameters, giving 100% coverage, so the baseline is 3. The tool description itself adds no information about how parameters relate to the returned template. The phrase 'Prompt discarded' does not clarify which parameter might be needed or how any of them influence the output.

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?

The description states a specific action: 'Return a three-step thinking template.' This is a clear verb+resource and not a tautology. While the phrase 'Prompt discarded.' adds slight ambiguity, the core purpose is understandable and the tool is distinct from its siblings.

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

Usage Guidelines2/5

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 any sibling tool, nor does it explain under what circumstances one should invoke 'think-steps'. The intended use case is left entirely to inference.

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

timezoneCInspect

Current time in a named IANA timezone.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description does not explicitly state whether the tool is read-only or has side effects. Although 'current time' strongly implies a read-only operation, the lack of explicit behavior details, especially with many unrelated optional parameters, leaves room for ambiguity.

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?

The description itself is a single concise sentence with no filler or redundancy. It directly states what the tool does, which is the ideal level of brevity for the core purpose.

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

Completeness2/5

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

The description is too minimal to be complete in context: it does not mention the output format, what happens if the timezone is invalid, whether all parameters are optional, or how this tool differs from the many siblings. The presence of numerous irrelevant parameters further reduces completeness.

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

Parameters1/5

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

The schema has 9 parameters but only 'zone' is plausibly relevant to a timezone tool. The other parameters (ref, url, city, feed, host, json, path, query) are entirely unrelated and have descriptions that suggest they belong to other tools, making the schema misleading and unusable for an agent without additional context.

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?

The description clearly states the tool returns the current time for a named IANA timezone, which is a specific function. However, it does not contrast with the sibling utc-time or iana-zones tools, so an agent may initially be unsure which one to pick.

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

Usage Guidelines1/5

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, no mention of how to provide the required timezone, and no example or edge-case instruction. The description only states the core function without any usage context.

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

utc-timeBInspect

Current UTC timestamp.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

B3.2/5.0
Behavior3/5

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 states the core behavior—returning the current UTC timestamp—but does not specify the timestamp format, clarify whether the nine input parameters affect the result, or explicitly note that it is a side-effect-free read.

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

Conciseness4/5

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

The description is exceptionally short and front-loaded with the essential information, with no filler. It is appropriately concise for a trivial utility, though it could do slightly more to clarify edge cases or output format.

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?

The description is adequate for a simple tool and states the essential return value, especially since no output schema exists. However, it does not explain why the tool accepts nine optional parameters or whether they are all effectively no-ops, leaving room for agent confusion.

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

Parameters3/5

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

Schema description coverage is 100%, so the baseline of 3 applies. The description itself adds no parameter semantics, but the schema already documents each parameter, including several marked as discarded after checks, so no major gap is introduced.

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?

The description clearly identifies the tool's output as the current UTC timestamp, which is a specific and understandable purpose. It does not explicitly differentiate from siblings like `timezone` or `iana-zones`, and it lacks an explicit verb, so it falls 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.

Usage Guidelines2/5

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. No exclusions, prerequisites, or sibling comparisons are provided, so an agent must infer entirely from the name and minimal description.

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

validate-jsonBInspect

Check whether a body is valid JSON. The body is discarded.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry the behavioral burden. It does disclose that the body is discarded, indicating the input is not retained, but it does not state whether the operation is strictly read-only, how invalid JSON is reported, or what error behavior to expect.

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 short declarative sentences, front-loaded with the core purpose and followed by one behavioral note. No filler, repetition, or tangential detail.

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

Completeness2/5

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

The tool has seven parameters, a fairly generic name amid several sibling validators, and no output schema or annotations. The description does not cover which parameter(s) to supply, what the result looks like, or when this tool is preferred, so it is incomplete for an agent deciding how to invoke it.

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

Parameters3/5

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

All seven parameters have descriptions in the input schema, so the schema already explains each field. The description adds no parameter-level meaning beyond repeating that the body is discarded; the relationship of parameters like city/feed to JSON validation remains undocumented.

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?

The description opens with a specific action and resource: 'Check whether a body is valid JSON.' It clearly identifies the core operation, though the term 'body' is slightly ambiguous and it does not say what result is returned. It is clear enough but lacks the sharp differentiation a 5 would require.

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

Usage Guidelines2/5

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

There is no guidance about when to use validate-json instead of sibling validators such as domain-shape, file-path-ok, or browser-url-ok. No exclusions, prerequisites, or alternative routing are mentioned.

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

weather-hintCInspect

Current temperature for a city via Open-Meteo.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2.9/5.0
Behavior2/5

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 only mentions the data source (Open-Meteo) but does not disclose that the temperature is a 'hint' for a city, that inputs other than city are discarded, or any caching/error/response characteristics. The schema's discard notes are not referenced in the description.

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?

A single, focused sentence that states the tool's purpose and data source with no filler. It is appropriately front-loaded and easy to scan. Nothing extraneous is included.

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

Completeness2/5

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

Given the complexity of the input schema (many parameters, even if discarded) and the absence of an output schema, the description is too sparse. It fails to mention return format, error behavior, or that only 'city' is used. An agent would not know whether the other parameters affect the call or what to expect in the response.

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

Parameters3/5

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

The input schema provides descriptions for all parameters (100% coverage), including clarity that non-city params are discarded. The description adds no parameter-specific meaning beyond mentioning 'city' indirectly. Baseline of 3 is appropriate since the schema handles the heavy lifting.

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?

The description clearly states the tool returns the current temperature for a city using Open-Meteo. It distinguishes it from the sibling tools, none of which cover weather. However, it uses a noun phrase rather than an explicit verb like 'get', and could more clearly state the action taken.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives, any prerequisites, or exclusions. There is no mention of when not to use it or how it differs from geo-hint or timezone tools. The agent must infer usage solely from the name and description.

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

web-fetchBInspect

HTTP status and content type for a public URL. Body discarded.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and does disclose an important behavior: the HTTP body is discarded. It also limits scope to public URLs. However, it does not mention redirect handling, error behavior, response format, or whether any headers/auth are needed, so transparency is only partial.

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

Conciseness4/5

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

A single sentence, front-loaded with the core value and ending with the important body-discarded caveat. It has no filler and is easy to scan, though it sacrifices some necessary detail for brevity.

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

Completeness2/5

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

There are no annotations, no output schema, nine optional parameters, and several closely related sibling tools, yet the description is only one line. It does not specify the return structure, which parameters to populate, or when not to use this tool, leaving significant ambiguity for reliable invocation.

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

Parameters3/5

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

Schema description coverage is 100%, so the baseline is 3; the description correctly emphasizes URL as the core concept. However, it does not clarify how the other eight optional parameters relate to a URL fetch, and the schema's `url` description ('normalize or cite') conflicts with the fetch behavior, leaving the description unable to resolve that confusion.

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?

The description clearly identifies the tool's core output: HTTP status and content type for a public URL, with the body discarded. It conveys a fetch/check operation even without an explicit verb, and the 'Body discarded' clause distinguishes it from full-content retrieval tools. However, it does not explicitly mention which parameter to use or differentiate from the sibling `fetch-status` tool.

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

Usage Guidelines3/5

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

The phrase 'public URL' and 'Body discarded' imply this is for lightweight status/content-type checks rather than full page fetching. But the description does not name alternatives or provide explicit exclusions, so an agent must infer when to use this instead of `fetch-status`, `browser-url-ok`, or `playwright-url-ok`.

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

wiki-title-okCInspect

Check whether a Wikipedia title exists. Title discarded after the call.

ParametersJSON Schema
NameRequiredDescriptionDefault
refNoGit ref name; discarded after the shape check
urlNoHTTPS URL to normalize or cite
cityNoCity name for a public weather hint; discarded after the call
feedNoPublic RSS or Atom URL; titles discarded
hostNoPublic hostname
jsonNoJSON text to validate; discarded after the check
pathNoFile path to check; no disk access
zoneNoIANA timezone name
queryNoSearch text; discarded after the length check

TDQS

C2.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It adds a small behavioral detail ('Title discarded after the call') but does not disclose whether the tool makes a network request, how it determines existence, possible side effects, or failure modes. The schema's repeated 'discarded' notes are not sufficient to explain behavior.

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

Conciseness2/5

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

The description is short, which is good, but it omits essential context. The single extra sentence about discarding the title is not useful without a corresponding parameter, and the description does not earn its place by clarifying invocation. It is under-specified rather than appropriately concise.

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

Completeness1/5

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

For a tool with a declared purpose of checking Wikipedia title existence, the absence of a title parameter and any explanation of how to call it makes the definition fundamentally incomplete. The schema is a grab-bag of unrelated fields, and there is no output schema or usage context. An agent would likely fail to invoke this tool correctly.

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

Parameters1/5

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

The description provides no explanation of parameters, and the schema's parameters (ref, url, city, feed, host, json, path) are unrelated to a Wikipedia title. There is no 'title' field, and the schema descriptions do not bridge the gap. An agent cannot determine which parameter, if any, should contain the Wikipedia title, making the parameter semantics actively misleading.

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?

The description clearly states the tool's action and resource: 'Check whether a Wikipedia title exists.' This is a specific verb+resource combination and is distinguishable from sibling tools by its focus on Wikipedia title existence. However, the description does not mention how this relates to the listed parameters, which slightly weakens clarity.

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

Usage Guidelines2/5

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, no prerequisites, and no exclusion criteria. The description simply states what it does without contextualizing the choice among the many '-shape' and '-ok' sibling tools.

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 28 tool updates
    • First observedagent-tool-index
    • First observedbrowser-url-ok
    • First observedcalc-eval
    • First observedcitation
    • First observedcompatibility
    • First observeddomain-shape
    • First observedfetch-status
    • First observedfigma-url-shape
    • First observedfile-path-ok
    • First observedgeo-hint
    • First observedgithub-repo-shape
    • First observedhn-front-count
    • First observediana-zones
    • First observedinspect-robots
    • First observedjira-key-shape
    • First observedlib-docs-hint
    • First observedmemory-key-count
    • First observednormalize-url
    • First observedplaywright-url-ok
    • First observedsearch-query-len
    • First observedstatus-catalog
    • First observedthink-steps
    • First observedtimezone
    • First observedutc-time
    • First observedvalidate-json
    • First observedweather-hint
    • First observedweb-fetch
    • First observedwiki-title-ok

Frequently Asked Questions

Discussions

No comments yet. Be the first to start the discussion!

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides the current date and time in the user's timezone through a simple tool with no parameters required.
    9,893
    -
  • A
    license
    C
    quality
    D
    maintenance
    Provides current time and date information with timezone support and multiple formatting options. Enables AI assistants to answer time-related queries in different timezones with detailed temporal information.
    2
    7
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides the current date and time in Pacific Daylight Time (PDT) via a remote Model Context Protocol server using Streamable HTTP transport. Requires no authentication and supports easy integration with Claude Code, Claude Desktop, and other MCP clients.
    -
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.