Skip to main content
Glama

ISO country NL

Server Details

Public ISO 3166-1 record for NL.

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

Multiple URL-status tools are nearly indistinguishable: browser-url-ok, playwright-url-ok, fetch-status, web-fetch, and citation all return HTTP reachability/status information. Several vague utilities like compatibility and think-steps have unclear boundaries with the rest of the set.

Naming Consistency3/5

Names are uniformly lowercase and hyphenated, and there are recognizable families like -ok, -shape, and -hint. However, the set mixes noun-based names, verb-based names, and outliers such as citation, compatibility, and think-steps, so no consistent pattern holds across all tools.

Tool Count2/5

28 tools is above the reasonable threshold and feels bloated for what is mostly a collection of micro-checks. Many tools could be consolidated into grouped utilities, such as a single URL-status tool with options instead of five overlapping variants.

Completeness2/5

The server's name suggests an ISO country domain, but there is no country-related tool at all, which is a striking gap. The broader surface also lacks coherent lifecycle coverage and mixes unrelated concerns like weather, timezones, JSON validation, and GitHub URL parsing without a clear unifying purpose.

Available Tools

28 tools
agent-tool-indexAInspect

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

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

TDQS

A3.8/5.0
Behavior3/5

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

There are no annotations, so the description carries the burden. It does disclose that task text is discarded and that the result includes certain artifacts, which is useful. However, it does not mention side effects, network behavior, authentication needs, or failure modes, and 'public' only weakly implies safety.

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 sentences, front-loaded with the main purpose, followed by returned artifacts and an important privacy note. Every phrase earns its place and there is no redundancy.

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

Completeness2/5

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

With nine optional parameters, no required parameters, no output schema, and no annotations, the description is too sparse. An agent cannot tell which of the many parameters to provide, whether one is sufficient, or what the returned artifacts look like structurally. The listed return values help, but the invocation semantics are incomplete.

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

Parameters3/5

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

Schema description coverage is 100%, so the baseline is 3 even without parameter details in the description. The description does not add meaningful semantics beyond the schema; 'Task text discarded' is a general behavior, not a parameter explanation. It neither helps nor hurts beyond the schema.

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

Purpose5/5

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

The description states a specific verb ('Find') and a specific resource: a public pay-per-call tool gateway (Monid). It also lists concrete return artifacts (CLI setup, how-it-works, skill file, remote MCP hops), which clearly distinguishes it from the sibling validators and hint tools.

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

Usage Guidelines4/5

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

The first sentence gives a clear invocation context: use this when you need to locate the Monid public pay-per-call gateway. It does not explicitly name alternatives or exclusion criteria, so it is not a 5, but the intended usage is much clearer than a vague 'for indexing'.

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

browser-url-okCInspect

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

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

TDQS

C2.9/5.0
Behavior2/5

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

The only behavioral disclosure is 'No browser is launched,' which is useful given the browser-related sibling tool. But with no annotations, the description should also clarify whether the check performs a network request, what happens on inaccessible URLs, or whether any state is changed. This level of disclosure is too thin to be considered broadly transparent.

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

Conciseness5/5

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

The description is two short sentences with no filler. The primary action is front-loaded, and the side-effect clarification follows immediately. Every word earns its place, making this appropriately concise for a tool of this apparent complexity.

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 an 8-parameter schema, no annotations, no output schema, and many sibling tools, the description is too sparse. It does not explain whether optional parameters are relevant, what the success/failure result looks like, or when an agent should select this tool over similar URL-related siblings. The description is minimally viable but incomplete.

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

Parameters3/5

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

The schema descriptions cover each parameter in detail, so the description does not need to repeat them. However, the description also does not add clarity about which parameter is actually the URL being checked, and the schema's `url` description says 'normalize or cite' rather than 'check openability,' which is a confusing mismatch that the description fails to resolve.

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

Purpose4/5

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

The description clearly states the action and target: 'Check whether a URL can be opened.' It also adds a useful distinguishing trait with 'No browser is launched,' which separates it from browser-launching alternatives. However, it leaves 'can be opened' ambiguous—it could mean syntactic validity, network reachability, or something else—so it is not a perfect 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?

The description provides no explicit guidance about when to use this tool versus alternatives like playwright-url-ok or fetch-status. 'No browser is launched' is a behavioral constraint, not a selection criterion. An agent would have to infer when this tool is preferable without any direct comparison or exclusions.

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

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It does reveal that the expression is discarded, implying no persistence, but it does not describe return values, error behavior, side effects, or any side-effect profile. This is insufficient for an agent to anticipate tool behavior.

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

Conciseness3/5

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

The description is short and front-loaded, with no filler. However, it is under-specified: 'Expression discarded' is ambiguous and the description omits essential context about inputs and outputs. It is concise, but not optimally complete for the tool's complexity.

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 9 parameters, no annotations, and no output schema, so the description must provide substantial context. It only states the purpose and one behavioral trait, leaving the agent unable to determine how to formulate a valid call. It is far from complete for a tool with this many parameters and sibling tools.

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

Parameters2/5

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

Schema description coverage is 100%, so the baseline is 3, but the description introduces a core concept ('expression') that does not map to any visible schema parameter. The fields shown are unrelated URLs, cities, file paths, and search text, so the description actively fails to clarify which parameter carries the arithmetic expression. Thus it provides misleading parameter semantics rather than useful added 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 clearly states a specific action ('Evaluate a+b style arithmetic') and distinguishes this tool from siblings, none of which advertise arithmetic evaluation. It is not a tautology and conveys the core purpose. However, the phrase 'a+b style' is an example rather than a precise specification of supported expressions.

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

Usage Guidelines2/5

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

The description gives no guidance on when to use this tool versus alternatives. It only adds 'Expression discarded,' which hints at statelessness but does not explain when this tool is appropriate or when a different tool should be chosen. No exclusions or alternative tool references are provided.

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

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

With no annotations, the description bears the disclosure burden; 'Page content is not stored' is a useful behavioral guarantee and implies a read-only, non-persistent operation. However, it does not disclose network behavior, rate limits, or side effects beyond that single guarantee.

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 sentences with the core result front-loaded and a single relevant privacy caveat. No filler or repetition.

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 tool has nine optional parameters and many sibling URL tools, but the description does not state that only `url` is the relevant input or how the result is shaped beyond three fields. Schema descriptions compensate somewhat, but the overall selection context is thin.

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 parameter's purpose, including which are discarded, is already documented. The description adds only the URL context and non-storage note, meeting but not exceeding the baseline.

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

Purpose4/5

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

The description names a concrete action ('Return host, scheme, and HTTP status for a URL') and resource, so an agent knows the primary output. It does not explicitly differentiate from sibling tools like fetch-status or normalize-url, so it falls short of a 5.

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

Usage Guidelines2/5

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

There is no guidance on when to choose this tool over siblings such as fetch-status, web-fetch, or browser-url-ok. The 'page content is not stored' note hints at a safe metadata use case, but there are no explicit when-to-use or when-not-to-use conditions.

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

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

No annotations are provided, so the description carries the full behavioral disclosure burden. It does state that identifiers are not retained, which is a useful privacy guarantee, but it does not disclose whether the operation is read-only, whether any external calls occur, or what 'classification' actually does.

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

Conciseness2/5

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

The text is short and front-loaded, but it is under-specified for a tool with 9 heterogeneous parameters. The privacy sentence earns its place, yet the core purpose sentence is too vague to be useful, so the brevity comes at the cost of necessary detail.

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

Completeness2/5

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

With no annotations, no output schema, and 9 optional parameters spanning URLs, paths, cities, feeds, hostnames, JSON, timezone data, and search text, the description is incomplete. It gives no indication of what the classification result looks like, what categories exist, or how the parameters map to a compatibility verdict.

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

Parameters3/5

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

The input schema has 100% parameter description coverage, so each of the 9 optional parameters is already documented in the schema. The tool description adds no parameter-level meaning beyond the generic 'no identifiers retained' statement, 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.

Purpose3/5

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

The description uses 'Show how this request is classified,' which indicates a classification or compatibility-checking purpose, but it never defines what the classification categories are or what kind of request is accepted. It is not a tautology, but it is vague and does not differentiate from siblings 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?

No guidance is given about when to use this tool versus sibling alternatives. The only contextual signal is the privacy claim about identifiers not being retained; there are no exclusions, prerequisites, or alternative tool names mentioned.

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.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 burden of disclosing behavior. It states that the operation is a pure split and that ownership/WHOIS data is not involved, which implies a read-only, local transformation. However, it does not mention error behavior, output format, or whether the other schema 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 one short sentence with no filler: verb, resource, result, and a scope qualifier. It is front-loaded and every word contributes.

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

Completeness2/5

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

There is no output schema, no annotations, no required parameters, and a 9-parameter schema, yet the description provides no output or return information, no error semantics, and no clarification of which parameters are relevant. An agent would need to infer the expected input and result from the name and one schema field.

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; each parameter has a description. The tool description adds no parameter-level meaning beyond naming hostname, and it does not explicitly map hostname to the host parameter, though the schema's 'Public hostname' description makes the connection recoverable.

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

Purpose5/5

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

The description uses a specific verb (split) and resource (hostname) and names the output (labels), immediately distinguishing this from sibling shape and check tools. The qualifier 'without WHOIS or ownership data' also sets expectations about scope. This is a clear, standalone statement of purpose.

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

Usage Guidelines2/5

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

No guidance is given about when to choose domain-shape over alternatives such as normalize-url, github-repo-shape, or url-ok tools. The only contextual clue is the negative scope 'without WHOIS or ownership data,' which does not tell an agent when to use this tool or what to use instead.

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

fetch-statusBInspect

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

B3.4/5.0
Behavior3/5

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

The description discloses the key behavior: it sends a HEAD request and returns only a status, not content. With no annotations, though, it does not cover error behavior, redirects, timeouts, or the distinction between valid URL, HTTP status code, and request failure; the schema's 'discarded after' fields also remain unexplained.

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; the verb and object come first and every word carries 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?

With nine optional parameters, no annotations, and no output schema, a one-sentence description is insufficient. It does not specify which parameter to supply, what 'status' looks like in the response, whether non-URL parameters are ignored, or how this relates to 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?

Input schema coverage is 100%, so the baseline is 3; the description itself adds no parameter-specific meaning. The 'url' parameter is the implied target, but the description does not confirm whether or how the other eight optional parameters affect the HEAD call.

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

Purpose4/5

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

The description names a specific action ('HEAD'), a target ('a public URL'), and an output ('status only'), which makes the tool's basic purpose unambiguous. It does not, however, resolve why the schema exposes many unrelated optional parameters, and it does not explicitly contrast with sibling fetch/status tools.

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

Usage Guidelines3/5

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

The phrase 'public URL' and 'status only' imply a lightweight status-check use case, but there is no explicit when-to-use/when-not-to-use guidance or mention of alternatives like web-fetch, browser-url-ok, or normalize-url. An agent must infer selection criteria from the one-liner.

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

figma-url-shapeBInspect

Parse a Figma file URL. Path discarded.

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

TDQS

B3.1/5.0
Behavior3/5

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

No annotations are present, so the description carries the full burden of behavioral disclosure. It reveals one behavioral trait, that the path is discarded, but it does not say whether the tool validates, fetches, or returns anything, nor how malformed URLs 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.

Conciseness4/5

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

The description is very concise and front-loaded: the core action appears first, and the behavioral note is a single additional fragment. It earns a high conciseness score, though the terseness contributes to ambiguity.

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

Completeness2/5

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

For a tool with nine optional parameters, no output schema, and no annotations, the description is too sparse to be complete. It does not specify which parameter to provide, what the parse result looks like, or how to handle invalid Figma URLs.

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 context by indicating that the input is a Figma file URL, which helps map to the `url` parameter, but it does not disambiguate among the nine optional properties or explain why unrelated parameters like `city`, `feed`, and `json` exist.

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

Purpose4/5

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

The description uses a specific verb and resource, 'Parse a Figma file URL', which clearly identifies the tool's target. The short 'Path discarded' adds a scope detail, though it is somewhat ambiguous about whether this refers to the URL path or the `path` parameter.

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

Usage Guidelines2/5

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

There is no explicit guidance about when to use this tool versus related siblings like `domain-shape`, `normalize-url`, or `github-repo-shape`. The description only states the action and does not mention exclusions, prerequisites, or alternatives.

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

file-path-okAInspect

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

A3.6/5.0
Behavior4/5

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

With no annotations provided, the description carries the behavioral burden and does disclose a key trait: no disk access. This tells the agent the check is side-effect-free and not a real filesystem verification, though it does not describe return behavior or error cases.

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

Conciseness5/5

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

Two short sentences with the action first and the safety caveat second. No filler; every word adds value.

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

Completeness2/5

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

There is no output schema and no annotations, yet the description does not state what the tool returns, what "safe" means, or how the nine optional parameters relate to the path check. An agent could call it with the wrong parameter or misread the result.

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 parameters are already documented. The description adds no parameter-level detail beyond the schema, and does not clarify whether the many non-path parameters are ignored or rejected.

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

Purpose4/5

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

The description states a specific verb and object: it checks whether a path looks safe, and adds that it performs no disk access. This is clear and enough to distinguish it from URL/title validators, though it does not explicitly differentiate itself from sibling tools.

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

Usage Guidelines3/5

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

"No disk access" implies this is the right tool for a purely static, shape-based safety check rather than a filesystem existence check, but it never says when to prefer this tool over alternatives or names exclusions. Usage context is implied, not explicit.

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

geo-hintBInspect

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

B3.1/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 behavioral disclosure. It only mentions Open-Meteo as the source and does not state whether the operation is read-only, how inputs are handled, what the return shape is, or any error 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.

Conciseness4/5

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

The description is one efficient sentence with no filler and front-loads the core output. It is concise, though that brevity contributes to missing behavioral and usage context.

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

Completeness2/5

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

With nine optional parameters, no output schema, and no annotations, a one-line description is insufficient. The agent cannot determine which parameters are relevant, what happens with no parameters, or what a successful or failed response 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 coverage is 100%, so the baseline is 3 and the description need not restate parameter syntax. However, the description does not clarify which of the nine parameters represents the 'place', leaving the agent to infer that 'city' is the intended input.

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 indicates that the tool returns latitude and longitude for a place via Open-Meteo. It avoids being a pure tautology of 'geo-hint', though it lacks a verb and does not explicitly differentiate itself from sibling tools like 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 Guidelines3/5

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

The description implies usage when coordinates for a place are needed, but it provides no explicit when/when-not guidance and names no alternative tools. Usage context is present only by inference.

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

github-repo-shapeBInspect

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

B3.2/5.0
Behavior2/5

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

No annotations are present, so the description carries the full behavioral burden, but it only states the parse operation. It does not disclose whether the URL is fetched, what happens for invalid/non-GitHub URLs, or what the return value looks like; with no output schema this matters.

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

Conciseness5/5

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

One sentence, nine words, with the verb and object front-loaded. There is no filler or duplication, and the statement earns its place.

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

Completeness2/5

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

For a tool with nine optional parameters, no annotations, and no output schema, this one-line description is thin. It does not describe the return shape, error behavior, non-GitHub input handling, or how this tool differs from the many URL/shape siblings, leaving an agent with substantial inference to do.

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

Parameters3/5

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

Schema coverage is 100%, giving the baseline of 3. The description adds some value by implying that the 'url' parameter is a GitHub URL rather than the schema's generic 'HTTPS URL to normalize or cite', but it does not clarify the roles of the eight other optional parameters or state that they are ignored for this 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 uses a specific verb ('Parse') and resource ('owner and repo from a GitHub URL'), so an agent can tell the core action. It does not explicitly distinguish this from sibling tools such as normalize-url or browser-url-ok, so it misses the top tier.

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

Usage Guidelines3/5

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

The description implies the usage context: choose this tool when a GitHub URL needs to be decomposed into owner and repo. It gives no explicit when-not-to-use guidance or references to alternatives, so selection among the many sibling tools 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.

hn-front-countCInspect

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

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

TDQS

C2.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. It discloses that titles are discarded and the count is current, but it does not explain whether the nine schema parameters are ignored, whether network access occurs, or what failure/return behavior to expect. 'Titles discarded' is useful but ambiguous.

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

Conciseness5/5

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

The description is extremely concise: two short sentences with no filler. 'Count current Hacker News front-page stories' is front-loaded and direct, and 'Titles discarded' adds a meaningful boundary without extra words.

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

Completeness2/5

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

For a tool with no annotations, no output schema, and a surprising nine-parameter input schema, this description is too thin. It does not specify the return value format beyond 'count', nor does it address the apparent mismatch between the tool's purpose and the unrelated parameters. An agent cannot confidently invoke it correctly.

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

Parameters3/5

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

Schema coverage is 100%, so the baseline is 3. The description adds no parameter-level meaning, and the nine optional parameters seem unrelated to counting HN stories. However, since all parameters are optional and the schema documents each one, the description does not actively mislead; it just fails to clarify whether any parameter matters.

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: 'Count current Hacker News front-page stories.' The added 'Titles discarded' hints at the output boundary. It does not explicitly contrast with sibling tools, but the operation is distinct enough from the listed shape-check and fetch tools.

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

Usage Guidelines2/5

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

No guidance is given about when to use this tool versus alternatives like web-fetch or fetch-status, nor whether any parameters should be supplied. The description implies a use case but provides no context, exclusions, or selection criteria.

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.5/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. The description only states the content domain ('IANA timezone names') and does not disclose what happens when the tool is called, what parameters are needed, whether the input is discarded, or what the output looks like. The schema descriptions mention 'discarded' behavior, but the tool description itself adds almost no behavioral transparency.

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

Conciseness2/5

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

The description is short and has no filler, which is superficially concise. However, it is under-specified for a tool with nine parameters and no annotations: a single noun phrase is not an appropriately sized description. Like the 'Process' example, this is more under-specification than effective conciseness.

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?

This tool has nine optional parameters, no output schema, and no annotations, yet the description provides almost no invocation context. An agent cannot tell which parameter to pass to get timezone names, how the tool behaves with multiple parameters, or what response to expect. The description is severely inadequate for the tool's complexity.

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 even though the tool description adds no parameter-specific guidance. The description does not explain how any of the nine parameters relate to 'IANA timezone names', which is a notable gap, but the schema itself documents each parameter. The description therefore neither adds value nor drastically misleads on parameter semantics.

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 relates to 'Common IANA timezone names for clock calls', so it identifies a resource and a general context. However, it lacks an action verb such as 'lists' or 'returns', making it unclear what the tool actually does. It also does not explicitly differentiate itself from the sibling tools 'timezone' or 'utc-time'.

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

Usage Guidelines3/5

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

The phrase 'for clock calls' implies when this tool might be used, but it does not explicitly state the conditions for use or provide exclusions. It does not mention any alternative tools or explain when not to use this tool, leaving the routing decision mostly to inference.

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

inspect-robotsCInspect

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

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

TDQS

C2.8/5.0
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 that only group counts are returned, but it does not explain that most parameters are discarded, which parameter selects the target site, or how errors are handled. The schema mentions 'discarded' fields, but the description itself is silent.

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 concise, front-loaded sentence with no filler. It clearly states the core action and result, though it is missing critical input mapping that would make it more useful.

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 9 parameters, no annotations, and no output schema, this description is severely incomplete. An agent cannot determine which parameter to provide, what 'group counts' means, or what the return format is. One sentence is wholly inadequate for a tool with this schema complexity.

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 no parameter-level meaning and does not clarify whether 'url' or 'host' is the relevant input for robots.txt. The schema descriptions themselves are ambiguous and include unrelated fields, so the agent cannot map the purpose to a parameter from the description.

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

Purpose4/5

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

The description states a specific action (fetch), resource (public robots.txt), and result (group counts only), which distinguishes it from sibling tools. However, 'group counts' is somewhat vague and the connection to the 9-parameter schema is not established.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus alternatives, no prerequisites, and no exclusions. The only implied usage is fetching robots.txt, but no sibling or alternative is mentioned.

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

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

With no annotations, the description carries the full behavioral burden. It does provide one useful behavioral disclosure: 'Key discarded,' indicating the key is not retained. However, it does not state whether this is a pure local validation, what happens on invalid input, or whether any result is returned, leaving important behavioral gaps.

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

Conciseness3/5

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

The description is short, front-loaded, and contains no filler words. But it is under-specified to the point of being skeletal: one sentence cannot adequately describe a tool with nine optional parameters and no output schema. Conciseness is present, but structure is minimal.

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

Completeness2/5

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

There is no output schema, no annotations, and a large set of optional parameters, so the description alone must explain input selection and expected behavior. It does not state the expected Jira key format, which parameter to use, what the tool returns, or how it handles invalid shapes. The definition is incomplete for correct 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?

Although schema_description_coverage is 100%, the description adds no mapping between the Jira key concept and the nine optional parameters. There is no `key` property; the closest candidate, `ref`, is described as a 'Git ref name,' and none of the other fields (url, city, feed, host, json, path, zone, query) are tied to the tool's stated purpose. An agent cannot determine 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 states a specific verb and resource: 'Check a Jira issue key shape.' This clearly distinguishes it from sibling shape-checking tools like github-repo-shape or domain-shape. However, it does not define what a valid Jira key shape is or indicate which schema field carries the key, so the purpose is recognizable but not fully actionable.

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 sibling shape tools, and no exclusions such as 'do not use for Jira lookups or issue metadata.' The only usage signal is the tool name and the verb 'check,' which is too weak for an agent to confidently select it among many similar tools.

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

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

With no annotations, the description carries the full burden and does add one meaningful behavior: the body is discarded, so only the status matters. It does not disclose request method, redirect/error behavior, authentication needs, or what counts as a valid library docs URL, leaving notable 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 no filler. The core operation and the key caveat are front-loaded, and 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?

For a tool with nine optional parameters, no annotations, and no output schema, this description is too thin. An agent cannot tell which input to provide, which URL shapes are valid, or how to interpret the returned status, making reliable invocation unlikely.

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

Parameters2/5

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

Schema coverage is 100%, but the description does not explain which of the nine optional parameters to use, and several parameters (city, json, zone, query) seem unrelated to the stated purpose. The schema's url description says 'normalize or cite' rather than 'fetch status', so the structured parameter info is of limited help and even somewhat conflicting.

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 operation—return the HTTP status of a public library docs URL—and notes that the body is discarded, so the agent knows what kind of result to expect. However, it does not differentiate this from sibling tools like fetch-status or web-fetch, which also deal with URLs and HTTP behavior.

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

Usage Guidelines3/5

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

The phrase 'public library docs URL' gives a narrow intended context, and 'body discarded' implies it should not be used when the response body is needed. But no alternatives are named and there is no explicit when-to-use versus when-not-to-use guidance, so usage remains mostly implied.

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.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, yet it only says values are discarded. It does not disclose whether the count is top-level or recursive, what happens with invalid JSON, what is returned, or whether the operation has side effects beyond discarding values.

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 concise and front-loaded: the action, 'count keys', appears in the first words. It is not padded, but it is terse enough that a bit more parameter guidance would have made it more useful.

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

Completeness2/5

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

For a tool with nine unrelated-looking parameters, no output schema, and no annotations, this description is not complete enough. An agent cannot infer the required input, the expected return value, or error behavior from the one-line description, especially with the schema's conflicting json parameter description.

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

Parameters2/5

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

Although the schema descriptions cover all parameters, the tool description never identifies which parameter supplies the JSON object whose keys are counted. The closest candidate, json, is documented as validation input that is discarded after the check, which does not match the stated count-keys behavior and leaves the mapping ambiguous.

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

Purpose4/5

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

The description states a specific verb and resource: count the keys in a JSON object. It is not a tautology, and 'Values discarded' adds a useful boundary, but it does not differentiate this tool from related JSON sibling tools such as 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 on when to use this tool versus validate-json, domain-shape, or other JSON-related siblings. 'Count keys' implies a use case, but no explicit context, exclusions, or alternative routing is provided.

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

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

With no annotations provided, the description carries the full burden for behavioral disclosure. It does disclose a key behavior: query and fragment are dropped. However, it does not mention that many of the input schema parameters are effectively ignored/discarded, nor does it describe behavior for invalid URLs or the exact return shape. This is partial transparency, not comprehensive.

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 consists of two concise sentences, front-loading the main return value and then stating the key behavioral caveat. There is no filler or redundancy, and it is appropriately sized for a simple URL-parsing tool.

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

Completeness2/5

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

Given the tool's schema has 9 parameters, no required fields, no output schema, and no annotations, the two-sentence description is insufficient. It does not explain how the returned origin/host/path are structured, which parameter is the actual URL input, or why so many unrelated parameters exist. The description leaves too much for the agent to infer.

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 9 parameters have descriptions in the schema, so schema coverage is 100%. The description adds no parameter-level detail beyond referring to a URL, and it does not clarify which of the many parameters is actually relevant. Since the schema already documents each parameter, including which are discarded, the baseline of 3 applies.

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

Purpose4/5

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

The description clearly states the tool's function: it returns origin, host, and path for a URL, and explicitly notes that query and fragment are dropped. This is a specific verb plus resource. However, it does not differentiate this tool from sibling URL-related tools such as browser-url-ok or figma-url-shape, 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 Guidelines3/5

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

The description implies when to use the tool: anytime you need the normalized origin/host/path of a URL. The statement that query and fragment are dropped also implies a limitation, but there is no explicit 'use when' or 'use instead' guidance, and no alternative tool is named. Usage guidance remains implied rather than explicit.

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

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

No annotations are present, so the description carries the full burden of behavioral disclosure. It discloses only that no browser is launched, omitting whether a network request is made, what 'can be opened' actually checks, and what the result looks like.

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

Conciseness4/5

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

The description is two short sentences, front-loaded, and contains no filler; the no-browser qualifier earns its place. It is not a 5 because the brevity contributes to the ambiguity around what 'can be opened' means.

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

Completeness2/5

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

For a tool with nine heterogeneous optional parameters and no output schema or annotations, this is incomplete: there is no return-value description, no network-behavior statement, and no relationship to the many URL siblings. An agent cannot confidently predict the tool's behavior or output.

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

Parameters3/5

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

Schema coverage is 100%, so the baseline is 3. The tool description adds no parameter meaning and does not explain why non-URL parameters like city, feed, json, zone, and query are accepted, but the schema itself provides descriptive text for each parameter.

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 verb and resource ('check whether a URL can be opened') and adds a useful qualifier ('No browser is launched'), so it is not a tautology. However, 'can be opened' is ambiguous—it could mean syntactic validity, DNS resolution, or HTTP reachability—and it does not clearly distinguish this from fetch-status or normalize-url.

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

Usage Guidelines2/5

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

The description provides no when-to-use guidance or alternative selection. The only contextual clue is that no browser is launched, which implicitly rules out browser-url-ok but fails to route the agent among multiple URL-related siblings like fetch-status, web-fetch, or normalize-url.

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

search-query-lenAInspect

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

A3.7/5.0
Behavior4/5

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

With no annotations, the description carries the behavioral burden, and 'Query discarded' is a useful disclosure that the query input is not retained. The operation is clearly read-only and non-mutating, though it could still state the return value more explicitly.

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

Conciseness5/5

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

The description is two short sentences with no filler. The main action is front-loaded and the side-effect note is compact, so every word earns its place.

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

Completeness3/5

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

The tool appears simple, but the schema exposes nine optional string parameters while the description mentions only one, and there is no output schema to clarify the return format. An agent is left to infer that only `query` matters and what exact result the tool produces.

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 schema already documents every parameter and many 'discarded' behaviors. The description adds little beyond identifying the query as the operand and does not clarify that the other eight parameters are irrelevant to this tool's function.

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 ('Count characters') on a specific resource ('a search query'), so the core purpose is recognizable. It is not a 5 because it does not explicitly differentiate from the many sibling count/check tools, and 'Query discarded' introduces slight ambiguity about what is returned.

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 reasonably implied: call it when you need the character count of a search query. However, the description gives no explicit when-to-use guidance, exclusions, or alternatives, leaving routing among 28 siblings mostly to inference.

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?

No annotations are provided, so the description carries the full burden of behavioral disclosure. 'Short catalog' implies a read-only informational listing and suggests limited scope, but it does not state what happens when called, what input is used, or why most parameters are described as 'discarded'. The description gives only a weak implicit hint of no mutation.

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

Conciseness2/5

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

The description is extremely short, but this is under-specification rather than effective conciseness. It lacks an imperative subject and does not front-load an actionable verb. While every word is minimal, the description does not earn its place because it fails to convey required usage information.

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

Completeness1/5

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

With seven parameters, no annotations, and no output schema, a one-line noun phrase is completely inadequate. The description does not explain why the parameters exist, which to provide, or what kind of catalog is returned. This leaves an agent unable to invoke the tool correctly beyond guessing.

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

Parameters3/5

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

Schema coverage is 100% since all seven parameters have descriptions, so the baseline is 3. The main description adds no parameter meaning, and the schema descriptions describe inputs as 'discarded' or 'checked' without explaining how they relate to HTTP status codes. The descriptions exist but do not establish a clear semantic link to the tool's purpose.

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 that essentially restates the tool name: 'Short catalog of common HTTP status codes.' It adds a vague qualifier but does not state an explicit action like 'returns' or 'lists', nor does it distinguish this catalog from sibling tools like fetch-status or compatibility. An agent cannot tell whether this is a static data object or a function to call.

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 in the sibling list. The description does not mention exclusions, prerequisites, or context. It is not misleading, but it provides no decision support for selecting this tool.

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

think-stepsCInspect

Return a three-step thinking template. Prompt discarded.

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

TDQS

C2.5/5.0
Behavior2/5

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

Annotations are absent, so the description carries the full behavioral burden. It discloses that the prompt is discarded, but it does not clarify whether the parameters matter, what the returned template looks like, or whether any side effects or dependencies exist.

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

Conciseness3/5

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

The description is short and front-loaded, but 'Prompt discarded' is under-specified and potentially confusing since no 'prompt' parameter appears in the schema. The brevity reads more like omission than effective conciseness.

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

Completeness2/5

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

With 9 parameters, no output schema, and no annotations, the description needs to explain what is returned and how the tool behaves. It only says 'Prompt discarded,' leaving the output format and invocation semantics 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 description adds no real parameter-level meaning beyond the cryptic 'Prompt discarded'; the schema already carries the parameter semantics.

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 concrete action ('Return a three-step thinking template'), so it is not a mere tautology. However, it does not explain what the template contains, how it should be used, or how this tool differs from the many sibling utility tools.

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

Usage Guidelines2/5

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

There is no when-to-use guidance, no mention of alternatives, and no conditions for choosing this tool over siblings. 'Prompt discarded' is a behavioral caveat, not a usage guideline.

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

timezoneBInspect

Current time in a named IANA timezone.

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

TDQS

B3/5.0
Behavior3/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It conveys a read-only current-time lookup and implies no side effects, but it does not describe behavior for invalid timezone names, DST handling, or whether the time comes from a system clock or external source.

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 sentence with no filler or redundancy, and the key facts—current time and named IANA timezone—are front-loaded. It is appropriately concise for the core function it describes.

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 absence of annotations and an output schema, combined with a schema full of unrelated optional parameters, leaves too much unspecified: the actual timezone argument, return format, and error behavior. An agent would struggle to call this tool correctly based solely on the provided definition.

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

Parameters2/5

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

Although the schema has 100% per-parameter descriptions, none of the listed fields (ref, url, city, feed, host, json, path, q) obviously accepts an IANA timezone. The description introduces the central concept of a named timezone without mapping it to any schema parameter, so an agent cannot reliably determine how to invoke the tool.

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

Purpose4/5

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

The description clearly states the tool returns the current time for a named IANA timezone, which identifies both the resource and the observable output. It also implicitly distinguishes this tool from siblings like utc-time and iana-zones, though it lacks an explicit verb and does not name those alternatives.

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 about when to prefer this tool over utc-time or iana-zones, and it gives no conditions, exclusions, or alternatives. Usage must be inferred entirely from the tool name and the phrase 'named IANA timezone.'

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

utc-timeCInspect

Current UTC timestamp.

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

TDQS

C2.7/5.0
Behavior2/5

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

With no annotations, the description must carry the behavioral disclosure burden. It only states the output (current UTC timestamp) and gives no hint that the tool accepts inputs such as ref, url, or city that are discarded after shape checks. The parameter descriptions in the schema imply a more complex behavior that the description omits.

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

Conciseness3/5

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

The description is a single short sentence and highly readable, but it is under-specified given the complexity of the schema. It is concise without being adequately informative, earning a middle score.

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

Completeness1/5

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

The tool has seven parameters and no output schema, yet the description explains none of the parameter behavior or return format beyond 'current UTC timestamp'. An agent cannot understand why parameters exist or what happens if they are supplied, making this description severely incomplete for a tool with this complexity.

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

Parameters3/5

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

The input schema provides a description for every one of the seven parameters, yielding high schema_description_coverage, so the baseline of 3 applies. The main description adds no parameter meaning, but the schema itself documents each parameter sufficiently.

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 function: returning the current UTC timestamp. It differentiates from siblings like timezone by explicitly scoping to UTC. However, it fails to reconcile the seven unrelated input parameters in the schema, leaving the tool's full purpose 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 guidance is provided on when to use this tool versus alternatives like timezone or other helpers. There are no conditions, exclusions, or mentions of sibling tools, so an agent is left to infer usage context.

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

validate-jsonBInspect

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

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

TDQS

B3.2/5.0
Behavior3/5

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

With no annotations, the description carries the behavioral burden; it does disclose that the input is discarded, which signals a non-persistent side effect. However, it omits the return value, error behavior for invalid JSON, and whether any network side effects occur from the URL/feed/host parameters.

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 core operation, and both sentences carry distinct information. There is no filler or repetition.

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

Completeness2/5

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

The description is too sparse for a tool with seven optional-looking parameters and no output schema or annotations. It never explains why parameters like ref, url, city, feed, host, and path are relevant to validating a JSON body, nor what result the agent can expect.

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 every parameter with descriptions, so the tool description does not need to restate them; coverage is effectively 100%. The description adds no parameter-level nuance and even substitutes 'body' for the 'json' property, which could be ambiguous.

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

Purpose4/5

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

The description names a concrete action ('check') and resource ('body'), and the suffix 'The body is discarded' clarifies this is a pure validation operation. It is distinguishable from sibling validators by focusing specifically on JSON syntax, though the term 'body' is vaguer than the actual 'json' parameter.

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

Usage Guidelines2/5

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

No guidance on when to choose validate-json over sibling validation tools such as domain-shape, github-repo-shape, or file-path-ok. The description does not mention alternatives, exclusions, or use cases beyond the generic validation.

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

weather-hintCInspect

Current temperature for a city via Open-Meteo.

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

TDQS

C2.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 full responsibility for behavioral disclosure. It identifies Open-Meteo as the source but does not describe whether the tool makes a network request, what units or format the temperature is returned in, how errors are handled, or that the other schema fields are explicitly discarded. This is not enough transparency for a tool with such a broad schema.

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

Conciseness3/5

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

The single sentence is short and front-loaded, with no filler. However, it is under-specified for a nine-parameter tool, and the brevity contributes to the ambiguity rather than serving as a model of efficient communication. It is concise, but not appropriately sized for the tool's complexity.

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

Completeness1/5

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

Given the tool has nine optional parameters, no annotations, and no output schema, the description omits nearly all context needed for correct invocation. It does not explain which parameter drives the weather result, what the response looks like, or how this tool relates to sibling tools like geo-hint or timezone. An agent cannot reliably choose and call this tool based on the description alone.

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 even without additional parameter details in the tool description. The description itself adds no parameter-level meaning and even creates tension by implying 'city' is the core input while it is only one of nine optional fields. The schema already explains the discard behavior, so the description does not need to compensate, but it also does not improve parameter understanding.

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 operation — returning current temperature for a city — and names the data source (Open-Meteo), which gives the agent a clear sense of the tool's purpose. It is distinguishable from likely siblings like geo-hint or utc-time by its weather-specific focus. However, it does not acknowledge the schema's many unrelated optional parameters, which creates some ambiguity about the tool's actual behavior.

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

Usage Guidelines2/5

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

No guidance is given about when to use this tool versus alternatives. The description does not mention that only 'city' is relevant, nor does it say what to do if the agent has a URL, host, JSON, or other input. With all nine parameters optional, the agent is left to infer the correct invocation context.

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 discloses one important behavioral trait: the HTTP body is discarded, so only status and content type are available. However, with no annotations to cover side effects or mutability, a network tool should ideally clarify things like redirects, timeout behavior, or whether the operation is a read-only GET/HEAD request.

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

Conciseness5/5

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

Two short sentences with no filler. The primary result is front-loaded, and the 'Body discarded' caveat is valuable and immediately relevant.

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 HTTP check, the description covers the main return values and the key constraint of a public URL. However, the unusual 9-parameter schema with unrelated fields is not explained by the description, and with no output schema or annotations, the agent is left to infer error behavior and how strictly the 'url' parameter is required.

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

Parameters3/5

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

Schema coverage is 100%, so all parameters are already described individually, including 'url' and the discard behavior of several fields. The description adds only the notion of a 'public' URL and does not explain how the unrelated optional parameters relate to the fetch behavior, but the schema carries the 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 states the tool's observable result: HTTP status and content type for a public URL, and clarifies that the body is not returned. This helps distinguish it from siblings like fetch-status and normalize-url, though it uses a noun phrase rather than an explicit verb such as 'returns'.

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

Usage Guidelines2/5

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

No guidance is given about when to choose this tool over alternatives. Siblings like fetch-status, browser-url-ok, and playwright-url-ok exist, but the description does not explain when web-fetch is the right choice or 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.

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

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

With no annotations present, the description carries the full disclosure burden. It does reveal that the title is discarded after the call, which signals no retention, but it does not state whether the tool is read-only, what it returns, whether it makes a network request, or what side effects might occur.

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 concise and front-loaded, stating the operation in the first sentence and adding a brief behavioral note in the second. Every sentence is short and purposeful, though the mismatch between 'title' and the schema reduces the usefulness of that efficiency.

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 eight parameters, no output schema, and no annotations, the description is severely incomplete. It never explains how 'title' maps to any input, what the return value looks like, or which parameters are required, leaving an agent unable to invoke the tool correctly.

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

Parameters2/5

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

The input schema documents all listed parameters with descriptions, but the description's core noun 'title' has no corresponding property among the eight schema fields. Rather than adding meaning beyond the schema, the description introduces a parameter mismatch that makes it harder for an agent to map the intent to actual arguments.

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 ('Check') and resource ('whether a Wikipedia title exists'), which is distinct from sibling tools focused on URLs, file paths, or Jira keys. However, it does not explicitly differentiate itself from alternatives beyond the Wikipedia-title scope, 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 siblings such as web-fetch, normalize-url, or citation. The description neither provides conditions for use nor mentions exclusions or alternatives.

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

  • A
    license
    Not graded
    quality
    C
    maintenance
    Format, validate and normalize international phone numbers, work out exactly how to dial one country from another, clean phone columns in CRM or contact exports, and find calling windows across time zones — using the countrycalling.codes API and MCP server.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides access to the Dutch national open-data portal (data.overheid.nl) via CKAN API, enabling listing organizations and datasets through direct tool calls or natural language queries.
    9
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Provides access to Dutch weather data (current conditions, forecasts, alerts, and historical data) via the KNMI API, with automatic location name resolution for Dutch cities.
    1
    13
    1
    Apache 2.0
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.