Skip to main content
Glama

America/Argentina/Buenos_Aires clock

Server Details

Current local time in America/Argentina/Buenos_Aires.

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

TDQS

C2.4/5.0

Scored across 28 tools

Disambiguation1/5

Several tools are near-identical: browser-url-ok and playwright-url-ok have the same description, and fetch-status, web-fetch, citation, and normalize-url all inspect public URLs. This makes it very hard for an agent to select the intended tool.

Naming Consistency3/5

Most names are lowercase kebab-case and many follow suffix patterns like -ok, -shape, -hint, or -count, which is readable. However, word order varies (fetch-status vs web-fetch, timezone vs utc-time) and there is no consistent verb_noun convention across the set.

Tool Count2/5

With 28 tools, the server exceeds the 'too many' threshold, and only a handful relate to its apparent clock/timezone purpose. Most tools are unrelated URL, JSON, or count utilities, making the set feel bloated and unfocused.

Completeness1/5

For a clock/timezone server, the surface is severely incomplete: it lacks timezone conversion, offsets, date/time formatting, and interval utilities. Instead, the majority of tools cover unrelated validation and URL-checking tasks, so agents cannot fulfill even basic timezone workflows.

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?

No annotations are present, so the description carries the behavioral transparency burden. It does disclose one meaningful trait: 'Task text discarded', indicating the tool ignores task text and implying a read-only lookup. It does not mention side effects, authentication needs, rate limits, or cost implications of the pay-per-call gateway.

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

Conciseness5/5

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

The description is a single front-loaded sentence that states the purpose, lists the returned artifacts, and adds a behavioral caveat. Every clause contributes value, with no filler or redundant restatement.

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 and no annotations, the description does enough to state what the tool returns and that task text is ignored, but it leaves ambiguity about how to invoke it correctly: no required parameters are indicated, and the relationship between the six input properties and the returned gateway information is unexplained.

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 extra meaning about how the six parameters relate to finding the gateway; it only mentions task text, which is not represented as a parameter in the schema. The schema itself carries the parameter documentation burden.

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

Purpose4/5

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

The description names a specific verb and resource: 'Find a public pay-per-call tool gateway (Monid)' and lists what it returns (CLI setup, how-it-works, skill file, remote MCP hops). It is clear enough to distinguish this tool from the sibling list, though 'Monid' is unexplained and no explicit sibling differentiation is given.

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: call this tool when you need to find the Monid pay-per-call gateway and its associated setup or hop information. However, the description gives no explicit when-not-to-use guidance, no alternatives, and no conditions for selecting it over other tools.

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

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

Beyond the note that no browser is launched, the description omits side effects such as network requests, error handling, or how the tool behaves with the provided parameters.

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

Conciseness4/5

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

The description is a single, clear sentence that is appropriately concise and front-loaded with the action.

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 description fails to explain what 'can be opened' means, what happens with the parameters (many of which seem unrelated), or what the tool returns, leaving significant gaps for an agent.

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 every parameter has a description, they are largely irrelevant to the stated purpose (e.g., git ref, city, JSON, timezone) and appear mismatched, providing misleading semantic value.

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 clearly states a specific action: checking whether a URL can be opened, and explicitly notes that no browser is launched.

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 provided on when to use this tool versus alternatives like fetch-status or web-fetch, nor any conditions indicating its preferred use.

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

calc-evalCInspect

Evaluate a+b style arithmetic. Expression discarded.

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

TDQS

C2.3/5.0
Behavior2/5

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

The only behavioral disclosure is 'Expression discarded,' which hints that the input is not retained. No other side effects, return behavior, or error handling are mentioned, and there are no annotations to fill the gap.

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 free of fluff, making it easy to read. However, it is so terse that it omits critical information, balancing the conciseness score down slightly.

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 description is incomplete for a tool with nine optional parameters and no output schema. It does not explain the return value, which parameter to use, or what 'discarded' means in practice, so an agent cannot reliably call it.

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 every parameter has a schema description, none of them relate to arithmetic expressions. The tool description does not specify which of the nine string parameters holds the expression, so the parameter semantics are effectively unexplained for this tool's purpose.

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 (evaluate) and resource (a+b style arithmetic), which distinguishes it from sibling tools. However, the phrase 'Expression discarded' and the mismatch with the input schema create some ambiguity about what exactly is being evaluated.

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, nor any context about the intended input. The description only says to evaluate arithmetic and that the expression is discarded, leaving the agent to guess how to invoke it.

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

citationBInspect

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

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

TDQS

B3.2/5.0
Behavior3/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure, and it does provide one meaningful behavior: page content is not stored. However, it does not mention authentication needs, rate limits, error behavior, whether a network request is actually made, or whether inputs are logged, leaving notable transparency gaps.

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

Conciseness5/5

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

The description is two short sentences with the primary behavior front-loaded. The second sentence about page content not being stored is a meaningful behavioral caveat rather than filler. It is highly concise and well structured.

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 exposes nine optional parameters, has no annotations, and has no output schema, yet the description only addresses the URL case and never explains the role of the other parameters. An agent cannot reliably determine which parameter is primary, whether parameters are mutually exclusive, or what the result shape looks like.

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 only connects the output to a URL and adds nothing beyond the schema's parameter descriptions; it also leaves unclear how the many unrelated-looking optional parameters like city, feed, json, and query relate to the stated 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 description clearly specifies the action (return), the resource (a URL), and the concrete outputs (host, scheme, and HTTP status), so an agent can understand the core function quickly. However, it does not distinguish this tool from siblings like fetch-status or normalize-url, and the 'citation' name is not explained.

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 explicit guidance about when to use this tool instead of fetch-status, web-fetch, normalize-url, or other siblings. The note that page content is not stored hints at a safe read-only use case, but it stops short of an actual when-to-use or when-not-to-use statement.

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

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

There are no annotations, so the description carries the full burden of behavioral disclosure. It does disclose a meaningful privacy trait: 'No identifiers are retained.' However, it does not mention whether the tool performs network calls, whether it is read-only, or what side effects, if any, exist.

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 compact and front-loaded, stating the core action first and the privacy guarantee second. It contains no filler or repetition, and each 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?

With seven heterogeneous inputs, no output schema, no annotations, and a large sibling set, the description is not detailed enough for an agent to know what input to supply, what classification result to expect, or how the tool relates to nearby tools. The privacy note is useful, but it is the only contextual information provided.

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 documents all seven parameters in detail, describing what each value represents and when it is discarded. The description itself adds no parameter-level meaning, so it does not improve on the schema's already strong coverage.

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

Purpose3/5

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

The description states that the tool 'shows how this request is classified', which is a specific action, but it never explains what classification means, what categories are possible, or what the output looks like. This leaves the purpose vague and does little to distinguish it from sibling classifiers like domain-shape or validate-json.

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

Usage Guidelines2/5

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

There is no guidance about when to use this tool versus the many sibling tools such as normalize-url, validate-json, or domain-shape. The description implies it is for classifying a request, but offers no use cases, exclusions, or alternatives.

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

domain-shapeBInspect

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

B3.2/5.0
Behavior3/5

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

No annotations are provided, so the description carries the full burden of behavioral disclosure. It does disclose one important trait: 'without WHOIS or ownership data,' indicating a limitation. However, it does not mention side effects, persistence, or return behavior. For a simple pure-function tool this is a modest but acceptable 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?

The description is a single, efficient sentence with no filler. The primary operation is front-loaded, and the clarifying qualifier 'without WHOIS or ownership data' adds value without bloat.

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 accepts eight heterogeneous parameters (ref, url, city, feed, host, json, path), but the description only mentions splitting a hostname. It does not explain the role of the other parameters or how they are used or discarded. This mismatch leaves the agent without enough context to confidently use the tool when non-hostname inputs are provided.

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 description adds no parameter-specific information, but the input schema provides descriptions for all eight parameters. Since schema coverage is effectively 100%, the baseline of 3 applies. The description's mention of 'hostname' relates to the 'host' parameter, but it does not clarify how other parameters such as 'city' or 'json' relate to the tool's purpose.

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 and resource: 'Split a hostname into labels.' It also adds a distinguishing qualifier, 'without WHOIS or ownership data,' which clarifies it is not a whois/lookup tool. While it does not explicitly name sibling tools, the scope is specific enough to avoid confusion with URL normalization or other shape-checking 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?

The description provides no guidance on when to use this tool versus alternatives. It simply states what it does; there is no mention of alternative tools like normalize-url or fetch-status, nor any conditions or exclusions. An agent is left to infer usage from the name and description alone.

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

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

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

With no annotations provided, the description must carry the behavioral disclosure burden. It does state the HTTP method (HEAD), the URL scope (public), and the output limitation (status only), which is meaningful. However, it says nothing about the behavior for the other eight accepted parameter types, side effects, or why inputs are 'discarded,' so transparency is only partial.

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

Conciseness4/5

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

The description is a single, front-loaded sentence with no filler words. It is concise and easy to parse, though its brevity comes at the cost of completeness given the tool's broad 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?

The tool has nine heterogeneous optional parameters and no output schema, yet the description only explains the URL-status case. It does not clarify what happens when no parameters are provided, what 'status' means for non-URL inputs, or what the return value looks like. This is not complete enough for correct invocation across the tool's actual surface.

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 every parameter in some detail. The tool description adds little semantic value beyond labeling the URL as 'public.' The baseline of 3 is appropriate because the schema carries the parameter meaning, but the description does not compensate for the mismatch between its URL-only framing and the actual parameter set.

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 concrete action, 'HEAD a public URL and return status only,' so it is not a tautology. However, the input schema exposes nine optional parameters covering URL, JSON, city, feed, host, path, query, and ref, so the description captures only one narrow mode and misrepresents the tool's broader purpose. An agent reading it would not know this tool also handles shape checks for non-URL inputs.

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

Usage Guidelines2/5

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

No guidance is given for when to prefer this tool over siblings like browser-url-ok, playwright-url-ok, or web-fetch. The phrase 'status only' weakly implies it should not be used when content is needed, but there is no explicit when/when-not guidance or mention of alternatives.

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?

With no annotations, the description carries the full burden of behavioral disclosure, but it only says 'Path discarded.' It does not reveal whether the tool performs network access, returns extracted components, validates format, or has other side effects. This is a significant gap for a tool that accepts nine unrelated string parameters.

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

Conciseness4/5

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

The description is extremely short and front-loaded: 'Parse a Figma file URL. Path discarded.' There is no wasted wording. However, the second sentence is cryptic and could mean either the URL path is ignored or the 'path' input is discarded, so the economy comes at the cost of 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?

Given nine parameters, no output schema, no annotations, and a large sibling set, the description is far too thin. It does not explain what result the agent should expect, how it relates to sibling shape-checking tools, or why nine mostly unrelated parameters are accepted. An agent lacks enough context to call this tool correctly with confidence.

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 every parameter, giving a baseline of 3. The description adds little beyond the schema; the phrase 'Path discarded' is ambiguous and does not meaningfully clarify the 'path' parameter or the URL path. No additional parameter semantics are provided.

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

Purpose4/5

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

The description names a specific verb ('Parse') and resource ('a Figma file URL'), and the tool name reinforces the Figma URL shape-checking domain. It is distinguishable from siblings like github-repo-shape and jira-key-shape. However, 'parse' is not fully precise about whether this validates, extracts, or normalizes, so it stops short of a 5.

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

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 choose this tool over alternatives such as normalize-url, browser-url-ok, or github-repo-shape. The description does not state conditions, exclusions, or preferred use cases, leaving the agent to infer usage from the name alone.

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

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

With no annotations, the description must carry the behavioral burden. It discloses one useful trait—no disk access—but does not state what the tool returns, what 'looks safe' means, whether it is pure, or how the many unrelated schema parameters factor in.

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 sentences, no filler, and the key constraint 'No disk access' is front-loaded. It scores well for brevity, though it is perhaps too terse for a schema with nine properties and no output schema.

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 definition is not complete for an agent. It has no output schema, no annotations, a nine-parameter input schema, and many sibling tools with similar-looking checks, yet the description explains only one parameter and never states the return contract or how the other parameters should be handled.

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 each parameter, including 'File path to check' and the 'discarded after' notes. The description adds no parameter-level meaning beyond that, which meets the baseline but does not resolve the confusion created by the nine-parameter schema.

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

Purpose3/5

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

The description names a concrete operation ('Check whether a path looks safe') and adds a useful constraint ('No disk access'). However, the input schema lists nine unrelated parameters such as url, city, feed, host, json, zone, and query, so the statement covers only one of several apparent inputs and leaves the tool's actual scope 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?

No when/when-not guidance is provided. The description implies a safe pre-flight check, but it never says when to choose this tool over siblings like browser-url-ok, normalize-url, or wiki-title-ok, nor when it should be avoided.

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

geo-hintCInspect

Latitude and longitude for a place via Open-Meteo.

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

TDQS

C2.7/5.0
Behavior2/5

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

With no annotations, the description carries the full burden of disclosing behavior. It mentions Open-Meteo as an external dependency and the coordinate output, but it does not describe the return format, network behavior, failure modes, or how the many 'discarded' schema parameters relate to the actual operation.

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 and the core output is stated immediately. It is concise, though the brevity comes at the cost of necessary operational detail.

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

Completeness2/5

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

For a tool with 9 optional parameters, no annotations, and no output schema, this one-sentence description is not enough for an agent to invoke it correctly. It omits required input selection, return shape, and the behavior of the numerous unrelated or discarded parameters.

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 all 9 parameters have schema descriptions, the tool description adds no mapping from 'a place' to a specific input parameter. The most plausible input, city, is described as 'City name for a public weather hint; discarded after the call', which conflicts with the stated geo-coordinate purpose and leaves the agent unsure which parameter to populate.

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 names the output ('Latitude and longitude for a place') and the source ('via Open-Meteo'), making the tool's basic purpose understandable. However, it is a noun phrase rather than a full statement with a verb, and it does not explicitly distinguish this tool from the sibling weather-hint.

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

Usage Guidelines2/5

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

There is no guidance about when to use this tool versus alternatives like weather-hint, timezone, or web-fetch. The only implied use case is needing coordinates, but no explicit context, prerequisites, or exclusions 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-shapeAInspect

Parse owner and repo from a GitHub URL.

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

TDQS

A3.7/5.0
Behavior3/5

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

No annotations are present, so the description carries the behavioral burden. 'Parse' implies a non-mutating read-only operation, which is helpful, but the description does not disclose whether the URL is fetched, validated, or normalized, nor what happens with the other accepted inputs.

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

Conciseness5/5

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

A single front-loaded sentence with no filler. It states exactly what the tool does without redundant qualifiers.

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 core operation is simple and the description conveys it, but there is no output schema, no required parameters, and no explanation of the many optional inputs. An agent can guess that 'url' is the input, but the return shape and edge cases are left unspecified.

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

Parameters4/5

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

The schema already describes every parameter, so the baseline is 3. The description adds key meaning beyond the schema by specifying that the 'url' should be a GitHub URL and that owner/repo are extracted, whereas the schema only says 'normalize or cite.' This clarifies the intended primary parameter.

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

Purpose5/5

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

The description names a specific verb ('Parse'), a specific resource ('GitHub URL'), and the extraction targets ('owner and repo'). It clearly distinguishes this from sibling shape tools like figma-url-shape or domain-shape.

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

Usage Guidelines2/5

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

The description gives no guidance on when to choose this tool over alternatives, and it does not state any exclusions or prerequisites. An agent must infer from the tool name and siblings.

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

hn-front-countBInspect

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

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 full burden and it does disclose one behavioral trait: titles are discarded. However, it does not explain whether the count is live/cached, what the return format is, or how the many parameters are handled.

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 deliver the core action up front and add a meaningful limitation with no filler. The structure is easy to scan.

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 output schema and no annotations, the description is thin: it omits the return type, whether the count is fetched live, and whether inputs are ignored. The presence of nine optional params without explanation also leaves an agent uncertain about how to call it.

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

Parameters3/5

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

Schema description coverage is 100%, so each optional parameter has a description and the baseline is 3. The tool description adds no parameter-level guidance and does not clarify why these nine unrelated optional parameters exist for a HN count tool.

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

Purpose4/5

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

The description names a specific operation ('Count') on a clear resource ('current Hacker News front-page stories'), and the 'Titles discarded' note clarifies the output scope. It does not explicitly call out sibling tools, but the unique HN resource makes the purpose easy to identify.

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: use it when you need a count of HN front-page stories and do not need titles. There is no explicit guidance about alternatives or when not to use it, so the context is clear but the routing is left to inference.

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

iana-zonesCInspect

Common IANA timezone names for clock calls.

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

TDQS

C2.8/5.0
Behavior2/5

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

No annotations are present, so the description alone must disclose behavior. It only says the tool provides common IANA timezone names, without explaining return format, side effects, or whether this is a lookup, list, or validation operation. The input schema mentions values being 'discarded,' which hints at side-effect-free behavior, but the tool description itself does not confirm anything.

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

Conciseness4/5

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

The description is short, front-loaded, and contains no filler. It delivers the core idea in a single sentence, though the brevity comes at the cost of missing important detail.

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 the tool has seven input parameters, no annotations, and no output schema, a one-sentence description is severely inadequate. An agent cannot determine what arguments to pass, what the tool returns, or how it relates to the seemingly mismatched input 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 input schema provides descriptions for all seven parameters, but those parameters (ref, url, city, feed, host, json, path) are unrelated to IANA timezone names in any obvious way. The tool description adds no connection or guidance about how these parameters should be supplied for a timezone-name operation, so the schema descriptions create confusion rather than clarity.

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 identifies a specific resource (IANA timezone names) and a context (clock calls), making the tool's general purpose recognizable. It lacks a verb, so it reads more like a noun phrase than an actionable definition, but it is not tautological and clearly distinguishes the topic from siblings like utc-time or timezone.

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 clock calls' provides a clear intended context for when the tool should be used. However, it offers no guidance about when not to use it or which sibling tools (e.g., timezone, utc-time) might be more appropriate for other time-related needs.

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

inspect-robotsBInspect

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

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

TDQS

B3.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 disclosure burden. It does disclose a meaningful limitation ('return group counts only') and the public scope of the fetch, but it does not describe error behavior for missing robots.txt files, redirects, timeouts, or which of the many optional parameters are ignored.

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, short sentence with no filler. It front-loads the action and the output constraint, 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?

Given nine optional parameters, no annotations, and no output schema, one sentence is not enough for correct invocation. The definition does not specify which parameter supplies the robots.txt URL/host, what 'group counts' means exactly, or what the return value looks like, leaving an agent to guess.

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

Parameters3/5

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

All nine parameters have schema descriptions, so the baseline is 3 even though the tool description adds no parameter-level detail. The remaining weakness is that none of the schema descriptions is clearly linked to robots.txt fetching, but the description itself does not contradict or worsen the schema.

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

Purpose4/5

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

The description states a concrete action and resource ('Fetch a public robots.txt') and narrows the result to 'group counts only', which makes the tool's purpose understandable and distinguishes it from generic fetch tools. It loses the top score because it does not explicitly say where the robots.txt comes from and does not contrast itself with siblings like web-fetch or fetch-status.

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

Usage Guidelines3/5

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

The word 'only' implies the tool is for group-count summaries rather than full robots.txt content, which gives some usage guidance. However, no alternative tool is named and no explicit conditions, prerequisites, or exclusions are provided, so the guidance remains mostly implicit.

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.3/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 full burden. It does disclose that the key is 'discarded', which suggests no retention, but it fails to state whether the tool returns a boolean, throws an error, or performs any other observable behavior. This is inadequate for a validation tool with no annotation support.

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 and front-loaded, but the second sentence 'Key discarded.' is confusing because there is no 'key' parameter in the schema. It is under-specified rather than concisely complete; a useful description would at least name the relevant argument.

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 no annotations, no output schema, and a mismatched multi-property input schema, the description is far from complete. It does not explain what the output looks like, which parameter to inspect, or how shape validation behaves for malformed inputs.

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 refers to a 'key' that does not exist in the input schema, which provides seven properties instead. Even though each property has a schema description, the tool description gives no hint about which parameter represents the Jira key, making selection ambiguous and error-prone.

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 ('Jira issue key shape'), which is enough to distinguish it from sibling shape-checking tools like domain-shape or github-repo-shape. However, it does not clarify what constitutes a valid Jira key shape or how 'key' maps to the input schema.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus alternatives, no mention of prerequisites, and no exclusions. The description only implies usage through the action word 'Check', but leaves the decision entirely to the agent.

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

lib-docs-hintBInspect

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

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 usefully discloses that only the HTTP status is returned and the body is discarded. However, it does not describe network-side behavior, failure handling, redirects, or the fact that most schema parameters are ignored during execution.

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, purposeful sentences with no filler. The core purpose is front-loaded and the body-discard behavior is a relevant secondary fact. Every word earns its place.

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

Completeness2/5

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

This is a nine-parameter tool with no annotations and no output schema, so more contextual burden falls on the description. It does not specify which parameter should be passed, what a returned status looks like, how errors are represented, or how this tool relates to the many sibling URL/status 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 baseline is 3. The description adds a slight clue that the url parameter is the relevant input, but it does not name that parameter or explain the role of the other eight parameters. The schema already documents most fields as discarded, so the description provides limited extra parameter meaning.

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: it returns HTTP status for a public library docs URL and discards the body. This makes it distinguishable from content-fetching tools like web-fetch, though it does not explicitly name or differentiate a sibling such as fetch-status.

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

Usage Guidelines3/5

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

'For a public library docs URL' gives clear context, but there is no explicit when-to-use or when-not-to-use guidance. The description does not name alternatives like fetch-status, browser-url-ok, or normalize-url, so an agent must infer the intended selection.

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

memory-key-countCInspect

Count keys in a JSON object. Values discarded.

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

TDQS

C2.3/5.0
Behavior2/5

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

The description mentions that values are discarded, which is a behavioral detail, but it does not explain how the other parameters are handled or whether any side effects occur. The lack of annotations leaves much 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 extremely concise, consisting of two short sentences, with no unnecessary words. It directly states the core function and a key behavioral note.

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 nine parameters and no output schema, the description is highly incomplete. It does not explain how to supply the JSON, what the output format is, or how the parameters interact, making it insufficient for reliable invocation.

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 tool description adds no information about the parameters; it does not clarify which parameter is the JSON input or how the others relate to counting keys. The schema already provides per-parameter descriptions, but they do not align with the tool's stated purpose.

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

Purpose3/5

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

The description clearly states the action ('Count keys in a JSON object') and a key detail ('Values discarded'), but it does not specify which of the nine parameters represents the JSON object, so the purpose is somewhat muddled by the schema.

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 provided on when to use this tool versus any alternatives. The description gives no context for selecting it over the many sibling tools.

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

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?

With no annotations supplied, the description carries the behavioral burden. It does disclose a real behavior: query and fragment are dropped, and origin, host, and path are returned. However, it does not mention failure behavior, read-only guarantees, or that apparently unrelated parameters such as ref, city, feed, json, host, and path are discarded, which the schema only hints at.

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 operation and followed by the key behavioral caveat. There is no filler, redundancy, or wasted wording.

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

Completeness2/5

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

The tool has seven parameters but the description only explains one of them and does not clarify the role of the others. An agent will not know whether it can ignore those parameters, what the 'path' output looks like, or how the tool behaves when the URL is invalid. The absence of an output schema makes this gap more significant.

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

Parameters3/5

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

All seven parameters already have individual descriptions in the schema, so schema coverage is high, and the baseline is 3. The description adds meaning only to the main URL behavior and does not clarify why the other parameters exist or how they relate to the stated task.

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 operation: return origin, host, and path for a URL, with query and fragment removed. This distinguishes it from sibling URL-validation tools like browser-url-ok and playwright-url-ok, which only check status rather than returning normalized components, though it doesn't explicitly name the alternative it is not.

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 when-to-use or when-not-to-use guidance, and no alternative tool is mentioned. The only implicit signal is that this tool is for extracting normalized URL components, but exclusions or conditions that would route an agent to a sibling tool are absent.

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

playwright-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.3/5.0
Behavior2/5

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

The only behavioral disclosure is 'No browser is launched', which is useful but incomplete. The tool does not explain side effects such as network access, status-code expectations, timeouts, or what it returns, and no annotations are provided to fill those gaps.

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

Conciseness4/5

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

The description is short and front-loaded, with the main point in the first sentence. It avoids unnecessary words, though the mismatch between the description and the parameter schema makes the overall tool harder to understand.

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?

No output schema or return-value description is provided, so an agent cannot know whether the result is a boolean, an HTTP status, or an error message. The tool's relationship to the many sibling URL/browser tools and its handling of the optional parameters are also unexplained.

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?

Parameter descriptions cover 100% of the schema, but most parameters (city, feed, json, path, zone, query) appear unrelated to checking whether a URL can be opened and have descriptions referencing discarded or unrelated behaviors. This actively misleads rather than clarifying which parameters actually affect the check.

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

Purpose3/5

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

The description states a specific check — whether a URL can be opened — and clarifies that no browser is launched, so the basic intent is recognizable. However, 'can be opened' is ambiguous (reachable? valid? rendering?) and the schema parameters do not align with that intent.

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 on when to prefer this tool over siblings like browser-url-ok, fetch-status, or web-fetch. It does not mention whether it performs an HTTP request, HEAD check, or some other method, nor when this lighter check should be used.

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

search-query-lenBInspect

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

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 transparency burden. 'Query discarded' does signal a no-retention, non-side-effecting behavior, and the schema repeats this for the 'query' parameter. However, the description does not disclose the return value, behavior when 'query' is absent, or whether the unrelated parameters are ignored.

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

Conciseness5/5

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

The description is two short sentences, front-loaded with the action and the key side-effect note. There is no filler, repetition, or irrelevant detail.

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

Completeness2/5

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

The tool has nine optional parameters, no annotations, and no output schema, so the description must provide more operational context. It omits what the tool returns, which parameter to pass, and how the other eight parameters are handled, leaving an agent with genuine ambiguity.

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 structured fields already document each parameter, establishing the baseline at 3. The tool description adds no parameter-level guidance, leaving the agent to infer that only 'query' is relevant to the length count.

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 ('Count') and resource ('characters in a search query'), so the core action is clear and matches the tool name. However, the nine-parameter schema includes many unrelated fields with no explanation of their relationship to the search query, which prevents a higher score.

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

Usage Guidelines3/5

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

The use case is implied: call this when a character count for a search query is needed. There is no explicit statement of when not to use it, no named alternative among the sibling shape/count tools, and no guidance on which of the nine optional parameters should actually be supplied.

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

status-catalogCInspect

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

C2.1/5.0
Behavior2/5

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

With no annotations provided, the description carries the full burden, and it only reveals that the output is a short set of common HTTP status codes. It does not explain input behavior, return format, side effects, or why seven unrelated parameters are accepted.

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?

While the text is only one sentence long, it is under-specified rather than appropriately concise. Given a seven-parameter input schema and multiple sibling tools, the single sentence does not earn its place because it omits crucial orientation about how to invoke the tool.

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 description is seriously incomplete for a tool with seven diverse parameters and no output schema. It does not explain what the catalog returns, how any input affects the result, or how this tool fits with the surrounding shapes and fetch utilities.

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

Parameters3/5

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

The input schema already provides a description for every parameter, so schema_description_coverage is high and the baseline is 3. The tool description adds no parameter meaning and does not explain how ref, url, city, feed, host, json, or path relate to a catalog of HTTP status codes.

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 rather than an action statement, so it does not state what the tool does. It essentially restates the name 'status-catalog' as 'catalog of common HTTP status codes', and does not distinguish this catalog from sibling tools like fetch-status or web-fetch.

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

Usage Guidelines2/5

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

There is no guidance about when to use this tool versus alternatives such as fetch-status or browser-url-ok. No conditions, exclusions, or comparisons are provided, so an agent has no basis for selecting this tool correctly.

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.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 transparency burden. 'Prompt discarded' is a useful disclosure that the input will not influence the result. But it does not clarify whether any of the eight parameters are actually used, and several schema parameter descriptions imply actions like normalizing, validating, or checking, which conflicts with the 'discarded' framing.

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 entire description is two short sentences with no wasted words. The core purpose is front-loaded first, and the key behavioral note comes second, 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?

For a tool with eight parameters, no annotations, and no output schema, this description is too thin. It does not explain why such a broad set of parameters exists, which parameter (if any) should be passed, or what the three-step template looks like; the action-oriented parameter descriptions actively undermine the 'discarded' claim.

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 documents all eight parameters with individual descriptions, so schema coverage is high and the baseline is 3. The description itself adds little parameter meaning; 'Prompt discarded' actually makes the role of these parameters more ambiguous rather than clearer.

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

Purpose4/5

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

The description clearly states a concrete action and resource: 'Return a three-step thinking template.' This distinguishes it from sibling tools like validate-json, normalize-url, or geo-hint, even 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 usage is implied: an agent would call this when a thinking template is wanted. However, there is no explicit guidance about when not to use it, whether arguments are required, or how it relates to the many other tools in the catalog.

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

timezoneCInspect

Current time in a named IANA timezone.

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

TDQS

C2.7/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It only says 'Current time...' and does not disclose whether the tool performs network access, validates the timezone name, or errors on invalid input. For a read-only helper, this is minimal but not sufficient.

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

Conciseness4/5

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

The description is one short, front-loaded sentence with no filler. It is concise and readable, but it omits critical guidance about the timezone parameter, so it is not fully well-rounded.

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 annotations and no output schema, the description was expected to cover input mapping and behavior. It covers neither, and the schema's unrelated parameters make the tool effectively unusable for a fresh agent. The description is too incomplete for the complexity introduced by the 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 schema has seven parameters, each with a description, but none is a timezone or IANA zone parameter. The description references a 'named IANA timezone' yet never maps that concept to a schema field. This mismatch is a serious gap that prevents an agent from knowing how to invoke the tool correctly.

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: 'Current time in a named IANA timezone.' This is clear and semantically distinct from siblings like utc-time and iana-zones. However, it does not explicitly reference those siblings or explain how the timezone is supplied, so it stops short of a 5.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus alternatives such as utc-time or iana-zones. The description gives no use cases, exclusions, or selection criteria. An agent must infer entirely from the tool name and sibling list.

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

utc-timeBInspect

Current UTC timestamp.

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

TDQS

B3.1/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 behavioral disclosure. It only states the output and omits that all nine input parameters are accepted but discarded, that the call is read-only/stateless, and what format the returned timestamp uses. The schema parameter notes cover the discarding behavior, but the description itself adds no behavioral context.

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. It front-loads the core purpose and is appropriately sized for a trivial timestamp utility.

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

Completeness3/5

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

For a zero-required-parameter utility, the description is nearly sufficient, but there is no output schema and the description does not state the timestamp format or explicitly say that all parameters are ignored. An agent can call it correctly with no arguments, but may be unsure how to interpret the response or why the parameters exist.

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%, with each parameter explicitly documenting its purpose or that it is discarded after a check. The description adds no parameter-level meaning, but the schema already carries the semantics, so the baseline score of 3 applies.

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

Purpose4/5

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

'Current UTC timestamp' clearly states what the tool returns: the current time in UTC. It is specific enough to distinguish it from generic time tools, though it does not explicitly contrast with siblings like timezone or iana-zones.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use utc-time versus alternatives such as timezone or iana-zones. It does not state any exclusions, prerequisites, or context that would help an agent choose this tool over siblings.

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

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

No annotations are supplied, so the description carries the transparency burden. It discloses the important side effect that the body is discarded. However, it does not state the return behavior (e.g., boolean result versus error) or the effect of invalid JSON, which an agent would need to know to use the result.

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

Conciseness5/5

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

The description is two short sentences, with the core purpose first and the side-effect warning second. Every word earns its place, and there is no redundant boilerplate.

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

Completeness2/5

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

The tool has no output schema and no annotations, so the description should provide enough context for correct invocation and result interpretation. It does not define what is returned, how invalid JSON is reported, or how the 'body' is supplied among the seven parameters. For an agent selecting among many shape-check siblings, this is a meaningful completeness gap.

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?

Every parameter already has a one-line schema description, and the tool description adds little beyond calling the primary input a 'body.' The json and path parameters are self-explanatory from the schema, so the description does not need to compensate. The unrelated-looking parameters (ref, url, city, feed, host) are individually described but still may confuse because the tool description does not relate them to validation.

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

Purpose4/5

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

The description states a clear action and object: 'Check whether a body is valid JSON.' The intent is easy to grasp and the name agrees. It does not explicitly contrast with sibling validation tools such as domain-shape or file-path-ok, so it falls short of full differentiation.

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 purpose implies when to use the tool: whenever an agent needs to decide whether some body is valid JSON. The warning 'The body is discarded' adds a negative usage condition, but there is no mention of alternatives or when not to use it beyond that side effect.

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
Behavior3/5

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

The description implies a read-only external lookup and adds the Open-Meteo source, which is useful context. However, the annotations are all false/absent and the description does not disclose units, return format, or side effects, leaving the agent with only a minimal behavioral profile.

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 wasted words. It is effective as a concise summary but slightly too thin to earn a 5 given the unusual input schema and missing guidance.

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 and seven parameters, several of which are explicitly discarded, the description should clarify the return value and why only 'city' matters. It provides enough for a basic call but leaves the agent guessing about output format and the role of the other parameters.

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

Parameters3/5

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

All seven parameters have schema descriptions, so the baseline is 3. The tool description only reinforces that 'city' is the primary parameter and does not add format, value, or semantic details beyond the schema.

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

Purpose4/5

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

The description clearly states that the tool returns the current temperature for a city and names the data source (Open-Meteo). It identifies the target resource and differentiates the tool from unrelated siblings, though it lacks an explicit verb like 'get'.

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 related sibling tools, and no exclusions or prerequisites. Mentioning 'Open-Meteo' gives provenance but not selection criteria.

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

web-fetchBInspect

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

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

TDQS

B3.3/5.0
Behavior3/5

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

The description transparently notes that the body is discarded, which is a meaningful behavioral detail and implies a read-only network fetch. However, with no annotations provided, it omits potential errors, redirects, auth requirements, or rate-limit 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?

The description is two short sentences with no redundant wording. It states the purpose, the output fields, and the key behavioral caveat about the body being discarded.

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

Completeness3/5

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

For a simple fetch operation, the description defines the return information and excludes the body. Yet with nine optional parameters and no required field, it does not fully clarify invocation expectations or edge cases, and it relies heavily on the schema descriptions.

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

Parameters3/5

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

All parameters have schema-level descriptions, several explicitly stating they are discarded after a shape check, so the schema carries most parameter information. The tool description itself does not add further guidance about which parameter is meaningful beyond implying URL.

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

Purpose4/5

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

The description clearly identifies the tool's output scope: HTTP status and content type for a public URL, and it explicitly says the body is discarded. It lacks an explicit verb, but the tool name and context make the action clear.

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 offers no direct when-to-use guidance, no prerequisites, and no mention of alternatives among sibling tools. The 'public URL' constraint is only implied, not stated as a selection criterion.

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

wiki-title-okCInspect

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

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

TDQS

C2.4/5.0
Behavior2/5

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

The phrase "Title discarded after the call" discloses one behavioral trait: no persistence of the title. But with no annotations present, the description carries the burden of explaining behavior, and it does not mention return values, error handling, network behavior, or whether this is a read-only operation. This is a minimal level of transparency, not a complete one.

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: two sentences and no filler. It front-loads the core purpose and adds the discard note efficiently. It is appropriately sized for a simple check, though the brevity comes at the cost of essential invocation details.

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 seven unrelated-looking parameters, no output schema, and no annotations, a 12-word description is far from complete. It does not identify which parameter is the title, what the response shape is, what 'exists' means in terms of output, or how failures are reported. An agent would not be able to invoke this tool confidently.

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

Parameters1/5

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

The schema has seven parameters, each with a description, but none is clearly the Wikipedia title referenced by the tool. The description does not map 'title' to ref, url, city, feed, host, json, or path, so an agent cannot determine which parameter to supply. The schema descriptions are internally coherent but disconnected from the tool's stated purpose.

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: "Check whether a Wikipedia title exists." This clearly distinguishes the tool from other shape-check siblings like browser-url-ok or github-repo-shape. However, it is slightly weakened by the input schema, which contains no obvious 'title' property and lists unrelated parameters like ref, url, city, and json.

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

Usage Guidelines2/5

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

The description gives no guidance about when to use this tool versus alternatives, nor does it mention exclusions or prerequisites. It does not say, for example, to prefer normalize-url for URL normalization or validate-json for JSON validation. Usage context must be entirely inferred from the name and the single sentence.

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

Tool Schema Changelog

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

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

Frequently Asked Questions

Discussions

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

Related MCP Connectors

Related MCP Servers

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

Glama MCP Gateway

Add one secure layer between your agents and this server.