Skip to main content
Glama

America/Monterrey clock

Server Details

Current local time in America/Monterrey.

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.1/5.0

Scored across 28 tools

Disambiguation1/5

Several tools are nearly indistinguishable: browser-url-ok and playwright-url-ok both 'check whether a URL can be opened' with no browser, and fetch-status, web-fetch, and citation all return URL status variants. URL-shape parsers also overlap across normalize-url, domain-shape, figma-url-shape, and github-repo-shape. An agent would frequently select the wrong tool.

Naming Consistency3/5

Names are uniformly lowercase and hyphenated, and there are recognizable suffix families (-ok, -shape, -hint). However, the set mixes verb-first names (fetch-status, normalize-url, validate-json) with noun-first names (domain-shape, timezone, status-catalog), so the convention is readable but not fully consistent.

Tool Count2/5

28 tools is already past the 'too many' threshold for a server whose apparent purpose is a timezone/clock utility. The large majority of tools (URL checks, Jira shapes, JSON validation, HN counts) are unrelated to that purpose, making the set feel bloated rather than well-scoped.

Completeness2/5

For a clock/timezone surface, basic operations exist (current time in a timezone, UTC time, IANA zone names), but common timezone workflows like conversion or date formatting are missing. The remaining 25 tools form an unrelated grab-bag and do not complete any coherent domain, leaving obvious gaps.

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.5/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 behavioral disclosure burden. It does add real behavior: 'Task text discarded' and the list of returned artifacts. It does not mention authentication, rate limits, costs, or whether external requests are made, so the behavioral picture is partial but not empty.

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?

Three short sentences with no redundant phrasing. Purpose is front-loaded, outputs are listed compactly, and the privacy-relevant discard behavior is a separate useful sentence. Every part earns its place.

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

Completeness3/5

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

The description explains what the tool returns and that task text is discarded, but with six unrelated-looking parameters and no output schema or annotations, it does not clarify which parameter (if any) drives the lookup or how the parameters relate to finding the gateway. The rich per-parameter schema descriptions prevent this from being a critical gap, so it is minimally adequate rather than fully complete.

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 even though the description itself says nothing about parameters, the structured schema already documents each one including discard behavior. The description adds no value beyond that baseline.

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 ('Find') and resource ('a public pay-per-call tool gateway (Monid)'), then lists concrete outputs: CLI setup, how-it-works, skill file, and remote MCP hops. This makes it distinguishable from the sibling utility tools, though it does not explicitly name an alternative.

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 is implied by 'Find a public pay-per-call tool gateway' and by the promised setup/skill output, but the description gives no explicit when/when-not guidance and does not mention alternatives such as web-etch, fetch-status, or normalize-url. Usage is inferable rather than clearly specified.

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

browser-url-okCInspect

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

C2.9/5.0
Behavior2/5

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

The only disclosed behavioral trait is that no browser is launched, which is useful but insufficient. With no annotations present, the description should also clarify whether the tool performs a network request, has side effects, or returns a yes/no answer. Without this, an agent cannot fully anticipate the tool's behavior.

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 redundant wording. The key differentiator, 'No browser is launched', is placed immediately after the main statement and 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?

For a tool with seven heterogeneous parameters, no annotations, and no output schema, this description is too thin. It omits the return value, the nature of the check, and any usage conditions. The schema fills in parameter meanings, but the overall contract for calling the tool remains incomplete.

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 seven parameters, so schema coverage is 100% and the baseline is 3. The description itself adds no parameter-specific meaning, and its single mention of 'URL' does not clarify why parameters such as city, json, or ref are accepted.

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 and object: 'Check whether a URL can be opened.' The addition of 'No browser is launched' helps distinguish it from browser-based siblings such as playwright-url-ok. However, 'can be opened' remains slightly ambiguous about whether this is a network reachability check, a format/parse check, or something else.

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 choose this tool over alternatives like fetch-status, playwright-url-ok, or normalize-url. 'No browser is launched' reads as a behavioral note rather than an explicit usage condition, so an agent is left to infer the appropriate context.

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

calc-evalDInspect

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

D1.7/5.0
Behavior2/5

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

With no annotations present, the description carries the full burden of behavioral disclosure. It honestly reveals that the expression is discarded, but never explains what the caller receives afterward — no return value, no error behavior, no side effects, no explanation of why every parameter is thrown away.

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?

Two sentences is terse, but the brevity hides critical information and the sentences contradict each other and the schema. This is under-specification masquerading as conciseness, not economical writing that earns each sentence.

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 eight heterogeneous parameters, no output schema, and no annotations, the description is severely incomplete: it omits return behavior, discard semantics across the parameters, and any linkage to the sibling tools whose inputs it mirrors. An agent cannot safely invoke this tool without guessing.

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 already describes each of the eight parameters with high coverage (each states it is discarded or checked), so the baseline is 3. However, the description's arithmetic claim maps to no parameter in the schema, actively misleading an agent about what input to pass, and it adds zero meaning beyond the schema.

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 states a verb and resource ('Evaluate a+b style arithmetic'), but immediately undermines it with 'Expression discarded,' and no input parameter accepts an arithmetic expression — the schema contains ref, url, city, feed, host, json, and path, all marked as discarded. An agent cannot discern the tool's actual function or what it returns.

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 or when to prefer an alternative, despite eight sibling tools (normalize-url, validate-json, weather-hint, geo-hint) whose parameter names appear in this schema. The description neither names alternatives nor states selection conditions.

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

citationCInspect

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

C2.7/5.0
Behavior2/5

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

With no annotations, the description must disclose side effects and non-obvious behavior. It only mentions that page content is not stored, which is helpful but leaves out error behavior, network usage, potential rate limits, and whether extra parameters are actually ignored.

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 brief and front-loaded, putting the primary output first. It does not waste words, though it could be expanded meaningfully to explain parameter handling.

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?

Without an output schema, the description should explain the return format and any relevant edge cases. It only lists the three fields returned but does not specify whether they are returned as a structured object, how errors are represented, or how the strange extra parameters affect execution.

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 every parameter has a schema description, many are unrelated to the stated purpose (e.g., city, feed, zone, query) and are only described as being 'discarded'. The relationship between these ignored parameters and the actual behavior is unclear, and the description does not clarify that only 'url' is used.

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 primary output: host, scheme, and HTTP status for a URL. The name 'citation' is somewhat opaque, but the verb 'Return' and resource 'URL' are sufficient to convey the core 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?

No guidance on when to use this tool versus alternatives such as fetch-status, normalize-url, or browser-url-ok. There is no mention of prerequisites, fallback behavior, or cases where this tool should be avoided.

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.6/5.0
Behavior3/5

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

With no annotations on the tool, the description carries full burden. It does disclose that identifiers are not retained, which is useful behavioral context, and 'Show' suggests a read-only operation. However, it does not say whether the request has side effects, what gets returned, or what happens with unsupported parameter combinations.

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 with no padding and the apparent purpose is front-loaded. The brevity is clean, though it comes at the cost of needed clarity.

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?

A seven-parameter tool with no output schema, no annotations, and many closely related siblings needs much more context. The description does not explain what classification looks like, which parameter to pass, or how it differs from the shape/validation siblings. This is too bare for an agent to invoke reliably.

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 independently describes all seven parameters and their discarding behavior, so schema_description_coverage is high. The tool description adds no parameter-level meaning, but the baseline of 3 applies because the schema already does the heavy lifting.

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 'Show how this request is classified' but does not define what kind of classification, what the result means, or how 'compatibility' relates to the request. It is not a tautology, but it is too vague to distinguish this tool from the many sibling shape-check/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 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 siblings like domain-shape, validate-json, normalize-url, or file-path-ok. The privacy statement implies it is safe, but that is not a usage criterion.

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

domain-shapeCInspect

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

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 must disclose side effects and read-only behavior itself. It only says 'without WHOIS or ownership data'; individual parameter descriptions mention 'discarded' and 'no disk access', but overall behavior, error cases, and output structure remain unspecified.

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, direct sentence with no wasted words. The qualifier 'without WHOIS or ownership data' is concise and adds meaningful differentiation.

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 9 optional parameters, no required fields, no output schema, and no annotations, the description omits essential context: which parameter is the hostname, what the returned labels look like, how invalid inputs are handled, and why the unrelated parameters exist.

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 descriptions cover 100% of parameters, most of them (ref, city, feed, json, path, zone, query) appear unrelated to the stated hostname-splitting purpose and seem copied from other tool domains. Only 'host' clearly aligns with the tool description.

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 and resource: 'Split a hostname into labels.' The exclusion of WHOIS/ownership data helps differentiate the tool from lookup-style tools, though it does not explain the output format or how to handle the many unrelated schema fields.

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 sibling tools such as normalize-url or github-repo-shape, and no explanation of which of the nine optional parameters should be provided. The only usage hint is the negative clause about WHOIS and ownership data.

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

fetch-statusCInspect

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

C2.7/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, but it does not disclose redirect handling, timeout/error behavior, or the fact that many schema parameters are explicitly 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 a single, focused sentence with no filler, though it lacks structured 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?

There is no output schema and the description only says 'status only' without specifying the status format, possible failure modes, or how to supply the target URL 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 every parameter has a description, the descriptions are misleading or off-topic (e.g., url is 'HTTPS URL to normalize or cite' and path is 'no disk access'), leaving unclear which parameter is actually used for the HEAD request.

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 (HEAD) and resource (a public URL) and identifies the output as status only, which distinguishes it from content-fetching tools like 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 about when to choose this tool over siblings such as browser-url-ok, normalize-url, or web-fetch, nor are any exclusions or recommended use cases provided.

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

figma-url-shapeCInspect

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

C2.9/5.0
Behavior2/5

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

There are no annotations, so the description must carry the behavioral burden. It only discloses 'Path discarded,' which conveys one minor behavior but says nothing about validation, return values, side effects, or failure modes. An agent cannot predict what the tool actually does with the URL.

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-loaded with the core purpose, and every word attempts to add information. It loses a point because 'Path discarded' is ambiguous and the definition is too terse to compensate for the confusing schema.

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?

Even though the ostensible operation is simple, the tool has 9 parameters, no annotations, no output schema, and a large set of siblings. The description does not explain what a Figma URL shape check returns, which parameters to pass, or how this tool differs from nearby tools like browser-ur-ok or normalize-url, leaving the agent under-informed.

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%, which normally earns a baseline of 3, but the parameter descriptions are generic and mismatched to this tool. For example, the url parameter is described as 'HTTPS URL to normalize or cite,' not as a Figma URL to parse, and many other parameters (city, feed, json, zone, query) appear irrelevant. With no required parameters, an agent cannot tell which inputs are actually meaningful for this operation.

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: 'Parse a Figma file URL.' This is clear and distinguishes the tool from sibling shape tools like github-repo-shape and jira-key-shape. The added 'Path discarded' gives a small behavioral detail, though the wording is somewhat ambiguous.

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 the tool should be used when a Figma file URL needs to be parsed, so a basic usage context is present. However, it gives no explicit guidance about when not to use it, nor does it reference alternatives among the many sibling shape tools.

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

file-path-okCInspect

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

C2.8/5.0
Behavior2/5

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

The description explicitly says 'No disk access', which is a useful safety trait. However, it does not disclose any other behavior, such as whether it returns a boolean or an error, or whether it might validate other parameters like the schema's unrelated fields.

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 extremely concise with two short sentences and no redundant information. It directly states the purpose and a key safety trait, making it easy to parse quickly.

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 omits essential details such as the definition of 'safe', the return type, and how to interpret the other schema parameters. Given the tool's simplicity, the lack of these details makes it incomplete for correct invocation, especially with the mismatched schema.

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 description adds no meaning about parameters; the schema descriptions are the only source. While the 'path' parameter is explained, the other eight parameters (e.g., 'ref', 'url', 'city') are described in a generic way that seems unrelated to the tool's stated purpose, creating potential 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 verb 'Check' and the resource 'whether a path looks safe', which is distinct from sibling URL-checking tools like 'browser-url-ok'. However, it does not specify what constitutes 'safe' or how it differs from a simple existence check.

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 indication of when to use this tool versus alternatives, nor does it mention any prerequisites or context. It only states the action without guiding the agent on appropriate scenarios.

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

geo-hintDInspect

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

D1.3/5.0
Behavior1/5

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

No annotations are provided, and the description does not disclose side effects, return behavior, or what happens with the supplied parameters. Several parameter descriptions mention 'discarded' or 'no disk access', but this does not clarify the tool's actual 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 a single short sentence, but it is vague and does not effectively communicate the tool's core function. The lack of structure and essential details makes it less useful despite its brevity.

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 is no output schema and no explanation of what the tool returns or how inputs map to outputs. Given the confusing parameter list, the description is insufficient for an agent to correctly invoke the tool.

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?

Although schema description coverage is 100%, the parameter descriptions are mostly unrelated to the stated purpose. For example, 'ref' is described as a Git ref, 'feed' as an RSS URL, and 'json' as JSON to validate, all of which seem disconnected from returning latitude and longitude for a place.

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 states 'Latitude and longitude for a place via Open-Meteo', which conveys a rough purpose, but it lacks an explicit verb and does not clarify which input represents the place. The parameter list contains many unrelated fields, further obscuring the tool's actual function.

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?

No guidance is given about when to use this tool versus alternatives. The sibling tools include related tools like weather-hint and normalize-url, but no distinctions or selection criteria are provided.

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

github-repo-shapeCInspect

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

C2.9/5.0
Behavior2/5

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

No annotations and no description of side effects, read-only behavior, return format, or failure modes; the one-line description only states the core action.

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 a single, front-loaded sentence with no filler, though it omits useful 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 is simple but the schema exposes 9 optional parameters with no required fields and no output schema; the description leaves ambiguity about inputs and expected result.

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 the schema has descriptions for all 9 parameters, they are generic and many appear unrelated to GitHub parsing; the description does not explain which parameter is the GitHub URL or how the others are used.

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?

Description clearly states the tool parses owner and repo from a GitHub URL, a specific verb and resource that distinguishes it from sibling URL-shape 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?

No guidance on when to use this tool versus alternatives such as figma-url-shape or jira-key-shape, nor any conditions or prerequisites.

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

hn-front-countCInspect

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

C2.6/5.0
Behavior2/5

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

The description discloses that titles are discarded, but it does not explain how the many input parameters relate to the tool's behavior, nor does it indicate that most parameters appear to be ignored or discarded. With no annotations, more behavioral clarity is needed.

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 extremely concise, consisting of two short sentences with no redundant or filler content. Every word contributes to the stated purpose or behavior.

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?

Given nine unrelated optional parameters and no output schema, a one-line description is insufficient for an agent to understand what inputs to provide or what output to expect. The description leaves critical context unaddressed.

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 adds no meaning to the nine optional parameters, which include url, city, feed, host, json, path, zone, query, and ref. These parameters appear unrelated to counting Hacker News front-page stories, and the description does not clarify their role or relevance.

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 primary action: counting current Hacker News front-page stories. The phrase 'Titles discarded' adds a specific behavioral note, though it is somewhat cryptic.

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 explicit guidance on when to use this tool versus alternatives, and no mention of related tools or fallback scenarios. The intended use is only implied by the action of counting front-page stories.

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

iana-zonesDInspect

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

D1.5/5.0
Behavior1/5

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

No annotations are present, so the description carries the full burden of disclosing behavior. It fails to mention side effects, input handling, or what happens to the provided parameters. The schema hints that inputs are 'discarded after shape checks,' but the description itself provides no behavioral transparency.

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, but it is under-specified rather than effectively concise. A single vague noun phrase provides no actionable content, so it is not 'appropriately sized' for the tool's complexity.

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 unrelated-looking parameters, no annotations, and no output schema, the description is radically incomplete. It does not explain the tool's return value, invocation pattern, or how the params map to IANA zones, making correct invocation impossible.

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 describes each parameter individually, so baseline is 3. However, the tool description does not explain how these diverse parameters (ref, url, city, feed, host, json, path) relate to IANA timezone names. This mismatch undermines an agent's ability to choose the correct parameter, reducing the description's contribution well below baseline.

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 is a noun phrase ('Common IANA timezone names for clock calls') with no verb indicating what the tool actually does. It does not state whether the tool returns, lists, validates, or resolves IANA zones, and it does not distinguish itself from sibling tools like timezone or utc-time.

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. The description mentions 'clock calls' but provides no context about scenarios, prerequisites, or exclusions, leaving an agent with no way to select it correctly.

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

inspect-robotsCInspect

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

C2.8/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 safety/behavior burden. It does state the operation is public/read-only and that only group counts are returned, which is useful. However, it omits error behavior, how the URL/host/path is selected, and what a 'group' means.

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 40-character sentence, no fluff, and the core action and result are front-loaded. Every word earns its place.

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, no examples, seven ambiguous parameters, and a terse description, an agent lacks the input mapping and expected return details needed to call the tool correctly. The description alone is not adequate.

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?

Schema description coverage is reportedly 0%, and the description names no parameter. The schema lists seven parameters with generic descriptions ('URL to normalize', 'Public hostname', 'File path to check') that do not say how to point the tool at a robots.txt file, so an agent cannot reliably map inputs.

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 focused action ('Fetch') on a specific resource ('a public robots.txt') and a precise result shape ('group counts only'), which separates it from generic fetch tools. It does not define 'group counts' or contrast with siblings, so it falls just 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 about when to prefer this tool over siblings like web-fetch, fetch-status, or normalize-url, and no mention of prerequisites. 'public robots.txt' provides only a weak implied use case.

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.7/5.0
Behavior2/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 of behavioral disclosure. It does reveal that the key is discarded, but it does not mention side effects, network access, return behavior, or error handling. The schema descriptions also repeat discarding details but add little else.

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 only two sentences and wastes no words; purpose and discard behavior are front-loaded. While it is under-specified overall, as a structural matter it is concise and readable.

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 no link between the stated purpose and the actual parameters, the description is far too sparse for an agent to confidently select and invoke the tool. The mismatched seven-field schema makes this especially incomplete.

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 input schema exposes seven optional string properties with generic descriptions, and the tool description never identifies which property is supposed to carry the Jira key. An agent cannot determine whether to pass ref, url, path, or another field. The schema's descriptive coverage does not help because none of the fields are described as Jira-key inputs.

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 gives a specific verb and resource: it checks the shape of a Jira issue key, which distinguishes it from sibling shape tools like github-repo-shape or domain-shape. However, the term 'key' is never connected to any input property, leaving a high-level but incomplete purpose.

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 phrasing implies the tool should be used when validating a Jira key shape is needed, but it provides no explicit context about when not to use it or which sibling shape tool to prefer. There are no stated alternatives or exclusions.

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

lib-docs-hintAInspect

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

A3.5/5.0
Behavior4/5

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

The annotations already mark the tool read-only and non-destructive; the description adds behavior beyond that: the response is an HTTP status and the body is discarded. This is a useful real constraint, telling the agent not to expect content. No contradiction exists.

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 redundant information. Every word adds meaning, and the description avoids repeating annotation or schema content.

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?

With no output schema, the description correctly says the result is an HTTP status and mentions body discard. However, it does not explain how the seven schema parameters are used, which one is needed, or what happens on errors/redirects, so it is adequate but not fully complete.

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, so the description does not need to repeat parameter details; coverage is 100%, which is a baseline of 3. The description does not clarify which parameter carries the library docs URL, but the schema's 'url' description is reasonably clear.

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 is specific: it tells the agent the tool returns an HTTP status for a public library docs URL and that the body is discarded. It lacks an explicit verb like 'return' or 'fetch', and it does not name a sibling, but the 'public library docs URL' scope separates it from generic status 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?

No when-to-use or when-not-to-use guidance is given, and no alternatives are mentioned. The only implied usage is when an HTTP status of a public library docs URL is needed, so the agent must infer when to prefer this over sibling tools like fetch-status or browser-url-ok.

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

memory-key-countAInspect

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

A3.6/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 a meaningful trait: values are discarded. But it does not state side effects, return format, error behavior, or whether the operation is strictly read-only, leaving room for assumptions.

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 sentences with no redundant wording. The core behavior is front-loaded and every phrase adds information.

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 nine optional parameters, no required inputs, no output schema, and no annotations, this description is incomplete. It does not explain how to specify the JSON object, what the return value looks like, or what happens when multiple or zero keys are supplied, so an agent could easily misinvoke 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?

Schema description coverage is 100%, so the baseline is 3. The description adds little per-parameter meaning; it refers to a generic JSON object without mapping to the nine optional properties or clarifying whether all supplied keys are counted or a single value should contain JSON text. The parameter descriptions themselves are more informative than the tool description.

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 states a specific verb-resource operation: counting keys in a JSON object and discarding values. This clearly distinguishes it from sibling tools like validate-json or domain-shape, which validate or inspect shape rather than return a key count.

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 operation itself implies when to use it: when a key count is needed and values are irrelevant. However, it does not explicitly state when not to use it, nor name alternatives such as validate-json or domain-shape, so an agent must infer the usage context.

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.2/5.0
Behavior3/5

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

The description discloses a key transform behavior: 'Query and fragment are dropped.' This is valuable because it tells the agent the output intentionally excludes those parts. However, with no annotations provided, the description does not disclose other behaviors such as error handling, whether only HTTPS URLs are accepted, or that all non-url inputs are effectively ignored despite being present 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?

Two short sentences carry all the essential functional intent with no filler. The core behavior is front-loaded and the caveat about dropped parts follows immediately. This is an appropriate size for a simple utility.

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 a simple surface description, the input schema contains seven seemingly unrelated parameters with odd 'discarded' notes, and there is no output schema or annotations. The description does not explain how these parameters relate to URL normalization or when only url should be supplied, so an agent may not call the tool correctly in complex or ambiguous cases.

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 describes each parameter, including the unusual 'discarded after the shape check' notes, so baseline is 3. The description adds some meaning for the url parameter by specifying that query and fragment will be dropped, which the schema description does not state. It does not clarify the role of the many other parameters or whether any are required.

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: 'Return origin, host, and path for a URL.' This clearly tells the agent what the tool produces. It does not explicitly contrast itself with sibling URL-related tools, but the scoped output makes the core purpose easy to grasp.

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 like web-fetch, browser-url-ok, or fetch-status. The description does not mention ideal scenarios, exclusions, or alternatives, leaving the agent to infer usage solely from the name and terse description.

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.4/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 a meaningful trait: no browser is launched, which counters the Playwright name. It does not disclose what the check does concretely (HTTP request? status-code threshold?), whether anything is returned, or why many schema inputs are discarded, so transparency is partial rather than complete.

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 extremely concise: two short sentences, front-loaded with the core action, and every word earns its place. 'No browser is launched' is necessary context rather than padding.

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 output schema, and no annotations, this description is insufficient. It does not define what the tool returns, how to indicate which URL should be checked, or what 'ok' means. An agent would struggle to correctly choose and invoke this tool among many similar siblings.

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-level meaning and does not clarify which of the nine inputs is the URL to check or why unrelated fields like city/json/timezone are present. It neither helps nor actively hurts beyond the already-rich 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 states a specific action ('Check') and resource ('whether a URL can be opened'), and the added 'No browser is launched' clarifies the mode. It is not a tautology and reads as a reachability/accessibility check. It stops short of 5 because 'can be opened' could mean valid shape vs. reachable over HTTP, and no sibling is named.

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?

Usage context is mostly implied: an agent can infer this tool is for checking URL openability without a browser, contrasting with browser-url-ok. However, there is no explicit when-to-use/when-not-to-use guidance and no named alternative. The 'No browser is launched' line is an exclusion, not a full routing rule.

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

search-query-lenDInspect

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

D1.9/5.0
Behavior2/5

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

With no annotations supplied, the description must fully disclose behavior. The only behavioral note is 'Query discarded,' indicating input is not retained, but it fails to mention output format, whether any parameters are ignored, or any side effects. For a tool with multiple input fields, this is insufficient transparency.

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 only two short sentences and front-loads the main action, but it is under-specified for the tool's complexity. The second sentence 'Query discarded' is useful, yet the overall description omits essential mapping and return information, so the brevity is not appropriate.

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?

Given 7 parameters and no output schema, the description is severely incomplete. It does not explain what the number of characters corresponds to, how the fields relate to the count, what the return value looks like, or when this tool is relevant. An agent would struggle to invoke it correctly without additional external knowledge.

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 descriptions for all 7 properties, so schema coverage is high, but the overall description actively conflates the purpose by referencing a 'search query' that does not map to any property. The description adds no clarification on whether each field is counted separately, concatenated, or only one is used. This creates param ambiguity rather than resolving it.

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 states a verb and resource ('Count characters in a search query') but the input schema contains no parameter named 'query'—only generic fields like ref, url, city, feed, host, json, and path. An agent cannot identify which field represents the search query, making the purpose vague and potentially misleading. It does not distinguish itself from sibling tools beyond the generic counting action.

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 provided about when to use this tool versus any of the many siblings (e.g., domain-shape, validate-json, web-fetch). The description gives no context, prerequisites, or exclusion criteria, leaving the agent to guess the tool's role.

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.7/5.0
Behavior1/5

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

With no annotations, the description carries the full burden, but it only says 'short catalog'. It does not state whether the operation is read-only, whether it performs any checks, or what side effects, if any, occur.

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 very short and front-loaded, but it is too sparse to be useful beyond the tool name. It does not structure any additional information.

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 optional parameters with no output schema or annotations, and the description does not explain how they relate to a catalog of HTTP status codes. The context is insufficient for an agent to invoke it correctly.

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 baseline applies. The description itself adds no parameter meaning, but the schema already describes each field, albeit with odd context-specific phrases like 'discarded after the shape check'.

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 names a resource ('common HTTP status codes') and 'catalog' implies listing, but it lacks an active verb or clear operation. It does not distinguish this from the many sibling tools that also involve status, fetching, or validation.

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 such as fetch-status or domain-shape. No conditions, exclusions, or examples are provided.

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

think-stepsBInspect

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

B3.2/5.0
Behavior3/5

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

No annotations are present, so the description must carry the transparency burden. It does state that the prompt is discarded, which is a useful behavioral clue, but it does not describe the template's contents, whether any side effects occur, or how the seven input fields are handled—several schema descriptions imply some are actually used.

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 sentences, front-loaded with the main action; no filler. The discard warning earns its place as a behavior note, though it could be clearer if it is meant to cover all inputs.

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 seven optional inputs, no output schema, and no annotations, the description is too thin. It does not say whether zero arguments are valid, which field to pass for a given intent, or what the returned template looks like. This leaves an agent guessing despite the schema's good per-parameter documentation.

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 JSON schema describes each of the seven properties ('Git ref name', 'HTTPS URL to normalize or cite', etc.), so coverage is effectively 100%; a baseline 3 applies. The tool description itself adds no parameter-level semantics beyond 'Prompt discarded,' which is ambiguous about whether input fields are ignored.

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 concrete action ('Return') and a concrete artifact ('a three-step thinking template'), so an agent can tell what the tool does. It stops short of a 5 because it does not position itself against sibling tools and the 'Prompt discarded' clause is initially ambiguous.

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 invoke think-steps versus the many sibling tools. No exclusions or alternatives are named, so the agent must infer usage from the name and template description.

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

timezoneBInspect

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

B3/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 disclosure burden. It states a read-like action but omits return format, invalid-zone behavior, and the fact that the listed schema inputs appear unrelated or discarded. This is minimal behavioral disclosure.

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 sentence with the action and scope front-loaded. There is no filler, repetition, or unnecessary 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 no output schema and no annotations, the description is the entire contract. It lacks the timezone argument, return format, error behavior, and alternative routing, leaving an agent unable to confidently invoke the tool as defined.

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 documents all seven parameters, but none of them is an IANA timezone; 'city' is explicitly tied to a weather hint and discarded. The description names the essential input concept without mapping it to any parameter, so an agent cannot determine how to pass the timezone.

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 precise operation — current time in a named IANA timezone — which clearly distinguishes it from utc-time and iana-zones in intent. It is not a tautology, but it does not explicitly point to sibling tools or explain how the zone name is supplied, and the schema never actually exposes a timezone parameter.

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?

Usage is implied: an agent can infer this tool is for wall-clock time in a specific IANA zone instead of UTC or a zone list. However, there is no explicit when-to-use/when-not-to-use guidance and no pointer to utc-time or iana-zones as alternatives.

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

utc-timeCInspect

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

C2.8/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 only states the output and does not mention that the nine input parameters are discarded, that no network/disk access is performed, or what the exact timestamp format is. The phrase implies a read-only operation, but given the unrelated schema fields, this under-disclosure is risky.

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 single-sentence description is concise and front-loaded, but it is under-specified for a tool with nine optional parameters and no output schema. It is not verbose, yet it omits necessary context, making it too terse rather than appropriately sized.

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 no annotations, no output schema, and an input schema of nine mostly irrelevant optional fields, 'Current UTC timestamp' leaves too much unspecified. An agent cannot know the return format, whether to pass any of the parameters, or how this differs from the sibling 'timezone' 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?

Schema description coverage is 100%, and each parameter already has a description, with several explicitly marked as discarded. The tool description itself adds no parameter semantics, so the baseline of 3 applies. It does not clarify why these unrelated params exist, but the schema already documents their behavior.

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 phrase 'Current UTC timestamp' clearly identifies the operation: return the current UTC time. It is specific enough for an agent to know what the tool produces, though it does not differentiate from the sibling 'timezone' tool or disclose the timestamp format.

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 alternatives like 'timezone'. The description does not state that all parameters are ignored or provide exclusions, leaving the agent to guess whether to pass any of the nine optional fields.

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 carries the full burden. 'The body is discarded' is a useful side-effect disclosure indicating no persistence, but the description does not explain validation scope, return behavior, or other operational traits. It is minimally transparent but not misleading.

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 sentences, front-loaded, with no filler. Every sentence contributes either the operation or a relevant side-effect 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?

With 9 optional parameters, no annotations, and no output schema, this description is under-specified. An agent still needs to infer which parameter is relevant, what the success/failure result looks like, and how this tool differs from sibling validation 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?

Schema description coverage is 100%, so the schema already documents all parameters. The description adds little beyond the schema and even introduces ambiguity by using 'body' rather than the `json` parameter name.

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 ('Check') and resource ('body' / JSON), making it clear the tool validates JSON syntax. However, it doesn't differentiate itself from sibling shape-checking tools, and the word 'body' is ambiguous relative to the schema's `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?

There is no guidance about when to use this tool instead of the many sibling validators, nor about what input to supply. The agent must infer from the tool name and schema that `json` is the relevant parameter.

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

weather-hintBInspect

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

B3.2/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 burden of revealing behavior. It does disclose the external data source and the returned quantity, but omit any side effects, failure modes, rate limits, or the fact the other input properties are discarded.

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 concise sentence with no filler. The key outcome is front-loaded, and every word contributes meaning.

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 whose schema exposes seven unrelated optional properties, the description does not tell an agent which paramaters actually matter, what the response format will be, or how failures are surfaced. With no output schema and no annotations, this is not enough for confident 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's descriptions already cover all seven parameters, so the schema carries the heavy lifting. The description only reinforces that city is the relevant input and adds no detail about formatting, units, or required fields.

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?

States exactly what the tool returns (current temperature), for what resource (a city), and via which provider (Open-Meteo). This clearly differentiates it from sibling tools such as geo-hint or web-fetch even without naming them.

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 weather-hint instead of a sibling, no prerequisites for the city value, and no exclusions. The only usable context is implied by the phrase 'for a city'.

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.4/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 behavioral disclosure burden. 'Body discarded' is a useful disclosure that prevents the agent from expecting HTML, and it names the returned values. It does not cover errors, redirects, rate limits, or auth requirements, 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.

Conciseness5/5

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

Two short sentences with no filler: the result, the URL scope, and the discarding behavior. The key constraint is front-loaded and every sentence 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 contains eight parameters and there is no output schema or annotations. The description addresses only the url case and ignores ref, city, feed, host, json, and path; it also does not describe the response shape, so non-URL inputs remain confusing for an agent.

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 every parameter, so schema coverage is effectively 100% and the baseline is 3. The description adds no parameter-level meaning and does not help an agent choose among the seven non-url parameters, but it does not misrepresent them.

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 purpose: return HTTP status and content type for a public URL, and it explicitly says the body is discarded. It avoids tautology, but it does not differentiate from close siblings like fetch-status 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 phrase 'for a public URL' and the stated output imply when to use it, but no alternative tools are named and no exclusions or prerequisites are given. Agents are left to infer the boundary with fetch-status and browser-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-okDInspect

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

D1.3/5.0
Behavior1/5

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

With no annotations, the description carries the full burden. It only says 'Title discarded after the call,' which is vague and does not explain the tool's overall behavior, side effects, error handling, or what happens with the other parameters. The mention of a discarded title is confusing since no title parameter exists.

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 extremely short, which is concise, but it is under-specified. The two sentences do not earn their place because they omit essential information about how to use the tool. There is no front-loaded critical guidance beyond a misleading purpose.

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 9 optional parameters, no output schema, and no annotations, the description is wholly inadequate. It does not explain the tool's role, how the parameters interact, what the tool returns, or any constraints. An agent has no basis for correct invocation.

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 adds no meaning to any parameter. The schema descriptions are present (100% coverage) but they are generic and unrelated to the stated purpose, e.g., 'Git ref name; discarded after the shape check.' The description does not tie these parameters to Wikipedia title checking, so it provides no additional value.

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 states a clear verb and resource: 'Check whether a Wikipedia title exists.' However, the input schema contains no title parameter—instead it lists unrelated fields like ref, url, city, and json. This makes the stated purpose misleading and inconsistent with the actual interface, so an agent cannot reliably determine what this tool does.

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?

No guidance is given for when to use this tool versus the many sibling tools (e.g., browser-url-ok, fetch-status, normalize-url). There is no mention of context, exclusions, or alternatives, leaving the agent to guess when this tool is appropriate.

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.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    A local Model Context Protocol server designed to share contextual information between an AI and a user. It primarily provides a tool to retrieve the current date and time in ISO 8601 format based on the server's local timezone.
    22
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.