ISO country DK
Server Details
Public ISO 3166-1 record for DK.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
- Repository
- sadri-dridi/named-mcp-utilities
- GitHub Stars
- 0
TDQS
Scored across 28 tools
Several tools have heavily overlapping purposes, with browser-url-ok and playwright-url-ok being near-identical duplicates. fetch-status, web-fetch, citation, and lib-docs-hint all effectively report HTTP status for URLs, and multiple tools parse URL shapes, making selection genuinely ambiguous.
Names mix verb-first forms like fetch-status and normalize-url with noun-first forms like calc-eval and web-fetch, plus single-word names such as citation and timezone. Suffixes like -ok, -shape, and -hint suggest a pattern, but it is applied inconsistently across the set.
28 tools is too many for what is mostly a collection of small URL, parsing, and time utilities, especially given the server name suggests an ISO country dataset. Many tools could be consolidated or removed, and the count feels inflated by redundant variants.
Despite being named 'ISO country DK', the server provides no country ISO lookup, subdivision, or country-data tools at all. The actual tools cover unrelated URL-checking, parsing, time, and validation tasks, so the surface is severely incomplete for the stated domain.
Available Tools
28 toolsagent-tool-indexBInspect
Find a public pay-per-call tool gateway (Monid). Returns CLI setup, how-it-works, skill file, and remote MCP hops. Task text discarded.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must carry behavioral context. It does disclose that task text is discarded and that the returned content includes CLI setup, skill files, and remote MCP hops. Still, it is vague about side effects, error behavior, or why many input parameters are accepted if they are ultimately discarded.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short and front-loaded: purpose first, then return contents, then a behavioral note. The 'Task text discarded' sentence is somewhat cryptic but not redundant; overall there is minimal filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema, all 9 parameters are optional, and the description never explains which parameters to provide or whether a no-argument call is appropriate. The phrase 'Task text discarded' hints that the input may be irrelevant, but an agent cannot confidently determine a valid invocation or expected return structure from this definition alone.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and each parameter includes its own discard/validation semantics, so the schema already carries the parameter-level meaning. The tool description adds no additional parameter context, but the high schema coverage keeps this dimension at baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action and resource: 'Find a public pay-per-call tool gateway (Monid)' and lists what it returns. This makes it reasonably distinguishable from the sibling validator/fetch tools, though 'Monid' is an unexplained proper noun and the exact relationship to the tool name is unclear.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The intended use is implied: call this when you need Monid gateway setup, how-it-works, skill file, or remote MCP hop information. However, there is no explicit guidance about when not to use it or how it compares to siblings, leaving the routing mostly to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
browser-url-okBInspect
Check whether a URL can be opened. No browser is launched.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description must carry the behavioral disclosure burden. It discloses the important fact that no browser is launched, but omits whether the operation is read-only, what the return value looks like, and why parameters like ref, city, feed, and json exist and are discarded. This is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a compact two-clause sentence that front-loads the action and states the key behavioral constraint. There is no word waste, though it is perhaps too terse given the number of unrelated parameters.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has seven parameters, several unrelated to URL checking, yet the description only addresses the URL aspect and the no-browser behavior. It doesn't explain what 'can be opened' means (network reachability, syntax check?), what the response contains, or how the extra parameters fit. The richness of the schema makes the description feel incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema gives each parameter a clear description, many with 'discarded after' notes, so schema_description_coverage is 100%. The tool description adds no parameter-specific meaning, but the baseline of 3 applies because the schema already documents the parameters well enough.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb and resource ('Check whether a URL can be opened') and adds a distinctive behavioral qualifier ('No browser is launched') that helps separate it from siblings like playwright-url-ok or web-fetch. It doesn't explicitly name sibling tools, but the core purpose is clear.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The 'No browser is launched' clause implies a lightweight, side-effect-free check, so an agent can infer this is preferable when browser launch is undesirable. However, there is no explicit 'use instead of X when...' guidance or any mention of prerequisites or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
calc-evalDInspect
Evaluate a+b style arithmetic. Expression discarded.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states 'Expression discarded,' which hints at no persistence, but it does not explain whether the tool returns a result, whether it only validates syntax, whether network/disk access occurs, or how errors are reported. This is insufficient for a tool with nine input fields and no output schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The text is brief and front-loaded, but it is too terse for the complexity of this tool. Two short sentences provide no structured breakdown of the nine parameters or call flow, so the conciseness comes at the cost of essential information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given nine parameters, no annotations, and no output schema, the description is radically incomplete. It omits what parameters actually do, which parameter carries the expression, what the return value is, and any side-effect or safety context. An agent has almost no basis for a correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema description coverage is 100%, the tool description introduces an 'expression' concept that does not map to any schema property. The schema parameters are about refs, URLs, weather, feeds, JSON, paths, and queries, so an agent cannot determine which parameter to populate for the arithmetic expression. The description adds confusion rather than clarifying parameter meaning.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a clear verb and resource ('Evaluate a+b style arithmetic'), but it never says which input holds the expression. The input schema contains nine unrelated string properties (ref, url, city, feed, host, json, path, query), none of which is described as an arithmetic expression, so an agent cannot tell what this tool actually consumes. This makes the purpose vague and likely misleading.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance about when to use calc-eval versus any of the many sibling validation tools such as domain-shape, file-path-ok, validate-json, or search-query-len. 'Expression discarded' implies a stateless call, but no explicit when-to-use or when-not-to-use context is 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.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds one useful behavioral disclosure: 'Page content is not stored.' This is valuable because the tool likely fetches a URL and the statement reassures about retention. However, with no annotations, the description still leaves important behavior unexplained, such as whether the call is read-only, how errors are handled, and the significance of the many 'discarded' inputs mentioned in the schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with the primary result front-loaded in the first sentence. The second sentence adds a relevant behavioral note without padding. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that there are no annotations, no output schema, and a surprisingly broad set of parameters, this description is too thin. It does not explain how to invoke the tool correctly among the many optional-looking params, why some inputs are discarded, or what the exact return shape is. The 'page content not stored' note is helpful, but the overall context is incomplete for reliable agent selection and invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema descriptions cover 100% of parameters, so the baseline is 3 and the description need not repeat schema content. It does not add clarity about which parameter should be supplied to satisfy the 'for a URL' behavior, and the schema's 'discarded' language is unusual. Thus the description contributes no extra parameter meaning beyond what the schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action and result: 'Return host, scheme, and HTTP status for a URL.' This is specific enough to indicate what the tool does, and the phrase 'for a URL' gives it a distinct scope. However, it does not explicitly differentiate itself from the sibling URL-checking tools like fetch-status or normalize-url, so it misses the top level of clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 such as fetch-status, normalize-url, or browser-url-ok. It implies a URL-related use case but does not state when it should be preferred or what distinguishes it from siblings. This is essentially no usage guidance.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of behavioral disclosure. It adds one useful fact—that identifiers are not retained—but says nothing about side effects, network access, validation behavior, or return values. The schema descriptions separately mention discarded data, so the description's own contribution is thin.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The text is short and front-loaded, and the privacy sentence does earn its place. However, the brevity comes at the cost of necessary specifics, so the size is not fully appropriate for a 9-parameter tool with no annotations.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 9 optional parameters, no annotations, and no output schema, this description leaves critical gaps: what output format to expect, what 'classified' means, and how the request should be shaped. An agent would have to guess or call the tool without enough context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the parameters are already documented in structured form. The description adds no parameter-level meaning, but the baseline 3 applies because the schema carries the documentation burden.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description says the tool 'shows how this request is classified' but never defines what classification means, what categories are produced, or what 'compatibility' refers to. It does not distinguish the tool from sibling tools 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.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to call compatibility versus any of the sibling tools. The privacy note is not a usage condition, and nothing explains what kind of request or parameter should be supplied.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
domain-shapeAInspect
Split a hostname into labels without WHOIS or ownership data.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden. It discloses a meaningful behavioral limit ('without WHOIS or ownership data') and implies a pure read-only transform, but it doesn't say how invalid hostnames are handled, whether non-host parameters are ignored, or describe any other side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One tight, front-loaded sentence with no filler. The core action and key exclusion are immediately visible.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Adequate for a simple pure function: the 'host' parameter is identifiable and all schema params are described. However, the gap between a single-behavior description and a nine-parameter schema, plus the lack of any output schema or annotations, leaves an agent uncertain about return format and the role of the extra parameters.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 the idea of splitting into labels, which maps naturally to the 'host' parameter, but it adds no guidance about the other eight optional parameters or whether they are ignored, so it doesn't rise above baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear verb and resource ('Split a hostname into labels') and adds a scope boundary with 'without WHOIS or ownership data.' It doesn't explicitly differentiate from sibling shape/validation tools like normalize-url or github-repo-shape, and the schema's many unrelated parameters are not reconciled, so it misses the top bar.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage context is implied: use it for syntactic hostname splitting, not for WHOIS/ownership lookups. There is no explicit when-to-use/when-not-to-use guidance and no named alternatives among the large sibling tool list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
fetch-statusCInspect
HEAD a public URL and return status only.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description does disclose the key behavioral traits 'HEAD' and 'status only,' signaling a lightweight operation that does not fetch a full body. However, it says nothing about how status is represented, failure behavior, or the fact that schema descriptions suggest most inputs are discarded after a shape check. With no annotations, this leaves significant behavioral uncertainty.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The sentence is short and front-loaded, with no filler. It is nevertheless under-sized for a tool with nine optional parameters and many sibling tools; the concision comes at the cost of necessary scoping information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no annotations, no output schema, and a broad input schema, the description is not complete enough. It fails to define what status is returned, how multiple inputs are handled, and how this tool relates to the URL/status sibling tools, so an agent cannot confidently invoke it for non-URL inputs based on this description.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
All nine parameters have schema descriptions, so the schema already carries most of the documentation burden. The description adds only 'public URL,' which maps to the url parameter, but does not clarify that all parameters are optional or which one should be supplied for a given check.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific action ('HEAD a public URL') and a constrained output ('status only'), which is clear for the URL case. However, the input schema accepts eight other inputs such as ref, city, json, path, zone, and query, so the stated purpose covers only a fraction of the tool's apparent surface and may mislead an agent.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance about when to use fetch-status versus sibling tools such as browser-url-ok, playwright-url-ok, web-fetch, or normalize-url. The phrase 'public URL' implies a reachability check, but no exclusions, prerequisites, or alternative routing are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
figma-url-shapeCInspect
Parse a Figma file URL. Path discarded.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of behavioral disclosure. It discloses one behavior, 'Path discarded,' but that phrase is ambiguous—it could refer to the URL path or the path parameter. Nothing is said about return values, validation behavior, side effects, or whether the tool performs network access.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very short and front-loaded with no filler, so it earns credit for conciseness. But the extreme brevity crosses into under-specification, leaving important ambiguities about input, output, and behavior.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 9-parameter tool with no output schema and no annotations, this description is far from complete. An agent cannot determine which parameter to populate, what the parsed result looks like, what 'Path discarded' means operationally, or how errors are handled. It is not sufficient to invoke the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 extra parameter detail in the description. However, the description adds no mapping from its behavior to the url or path parameters, and 'Path discarded' appears to conflict with the schema's path description ('File path to check'). This prevents the description from adding meaningful clarification.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb and resource ('Parse a Figma file URL') and adds the detail that path is discarded, so it is not a tautology. However, 'parse' is ambiguous: it does not say whether the tool validates the URL shape, extracts a file key, normalizes the URL, or returns some parsed structure. It also does not distinguish itself from sibling URL-related tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance about when to use this tool versus normalize-url, browser-url-ok, or other shape/URL tools. The description does not state which parameter should carry the Figma URL, nor does it give any exclusion criteria. The only implied trigger is 'has a Figma file URL,' which is too vague to be actionable.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
file-path-okBInspect
Check whether a path looks safe. No disk access.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the behavioral disclosure burden. It does disclose an important trait: 'No disk access.' However, it does not state the return contract (e.g., boolean ok), what 'safe' means, or whether it rejects traversal patterns. This is useful but incomplete for a tool with no structured annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with no filler. The core purpose is front-loaded, and the behavioral caveat is immediate. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
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, no output schema, and many sibling tools, two sentences are insufficient. The description does not clarify which parameter is relevant, what the return value looks like, or how this tool relates to sibling checkers. The schema covers parameter names, but the overall invocation context remains under-specified.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the description does not need to repeat parameter meanings. The description adds no parameter semantics beyond the schema, and the tool description only implies 'path' while the schema lists nine optional parameters including url, json, and city. This ambiguity is not resolved by the description, but the schema itself covers each parameter well.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states a specific verb and resource: 'Check whether a path looks safe.' The added 'No disk access' gives a useful scoping clue. However, it does not explicitly differentiate from sibling shape-checking tools like validate-json or domain-shape, so it stops short of full sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance about when to use this tool versus alternatives. The sibling list contains many overlapping checkers and shape validators, but the description provides no when/when-not conditions or alternative tool names. 'No disk access' is the only contextual hint, which is not enough for routing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
geo-hintCInspect
Latitude and longitude for a place via Open-Meteo.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must carry the behavioral disclosure burden, but it only names the data source and output. It omits that many schema parameters are discarded after shape checks, what happens with multiple inputs, error behavior, and the response shape.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single front-loaded sentence with no filler, which is efficient and easy to parse. It is slightly too sparse for the tool's nine-parameter schema, but conciseness itself is handled well.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
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, a one-line description is insufficient. It does not explain which parameter selects the geocoding behavior, how the other parameters relate, or what the caller should expect in response.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so every parameter already has a description such as 'City name for a public weather hint; discarded after the call.' The tool description adds little parameter-level meaning beyond 'place,' so the baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear function: produce latitude and longitude for a place using Open-Meteo. It is not a tautology and conveys a specific output and service, though it does not explicitly name alternatives or the exact input parameter to use.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus siblings like weather-hint or iana-zones. The phrase 'for a place' implies a geocoding use case, but no explicit when-to-use/when-not-to-use or alternative routing is given.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of behavioral disclosure, but it only states the parse action. It does not mention error behavior, whether unrelated parameters are ignored, or whether the operation has side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single front-loaded sentence with no filler, making it concise. However, for a tool with nine parameters and no output schema, this brevity borders on under-specification.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is incomplete for correct invocation: it does not specify return values, invalid-input behavior, or which parameters should actually be supplied. With no output schema and no annotations, the agent is left to infer essential usage details.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 GitHub-specific meaning to the url parameter, but it does not clarify how the other eight optional parameters relate to the stated purpose.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
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 owner and repo from a GitHub URL.' It clearly differentiates this tool from sibling shape tools like figma-url-shape or jira-key-shape by naming GitHub as the target.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided about when to use this tool versus related URL-shape tools, what conditions select it, or what happens with non-GitHub URLs. Usage is only implied by the tool name and the one-line description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
hn-front-countAInspect
Count current Hacker News front-page stories. Titles discarded.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations and no output schema, so the description carries the behavioral transparency burden. It discloses a meaningful behavioral trait: 'Titles discarded' tells the agent that story titles will not be returned. It does not explicitly state return type, live-fetch behavior, or that optional inputs are ignored, but for a simple read-only count tool the key behavioral note is present.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with no filler and the core action is front-loaded. 'Titles discarded' earns its place by setting an important expectation about the output. The terseness is efficient rather than wasteful.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple count tool, the description gives the essential action and one clear output limitation. However, the nine optional parameters with mostly unrelated semantics create potential confusion, and the description never states that no meaningful input is required or that parameters may be ignored. A brief note about invocation expectations would make it complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 description adds no parameter-specific information. The schema already documents each parameter, though many appear unrelated to HN front-page counting. The description does not clarify whether these parameters are accepted, ignored, or relevant, which is a modest gap.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
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 current Hacker News front-page stories.' It also sets clear scope with 'current' and clarifies that titles are not part of the result, distinguishing it from generic fetch or news tools. This is a clear, non-tautological 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.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The purpose itself implies when to use the tool: when only the count of current Hacker News front-page stories is needed. However, it does not explicitly name alternatives or provide when-not conditions beyond the terse 'Titles discarded' hint. No sibling tools are referenced, so an agent must infer the appropriate context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
iana-zonesDInspect
Common IANA timezone names for clock calls.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It reveals no behavior at all: no indication of whether the tool lists, validates, resolves, or filters IANA zones, and no side effects, output, or failure modes are mentioned.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short, but its brevity comes from under-specification rather than efficient communication. It front-loads nothing useful beyond a vague noun phrase and does not earn its place as a tool definition.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, no annotations, 9 parameters, and a one-line noun phrase, the description is completely inadequate. An agent cannot determine what action to take, what arguments matter, or what the tool returns.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 description itself adds no parameter information. The schema gives each property a clear meaning, but the description does not connect these parameters to the tool's purpose or clarify why they appear in iana-zones.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description is essentially a noun phrase that restates the tool name: 'IANA timezone names' mirrors 'iana-zones'. It lacks a specific verb (list, validate, return) and does not distinguish this tool from siblings like timezone or utc-time.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The only usage hint is 'for clock calls', which implies a context but gives no concrete guidance on when to choose this tool over alternatives such as timezone or utc-time. No exclusions, prerequisites, or alternative routing are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
inspect-robotsBInspect
Fetch a public robots.txt and return group counts only.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the disclosure burden, and it does convey that this is a read-only network fetch of a public resource that returns only group counts. However, it does not say what happens on missing or invalid robots.txt, whether redirects are followed, or how the fetched content is processed beyond counting groups.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One short front-loaded sentence with no filler; the word 'only' usefully rules out returning the full robots.txt. This is appropriately concise for the amount of information it actually provides.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
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, so the description must explain both invocation and return format, but it only says 'group counts only'. It does not state which parameter supplies the target URL or host, nor the shape of the returned group counts. With nine parameters, this is not enough for a confident call.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema coverage is 100%, the description never connects the robots.txt task to a specific input parameter, so it is unclear whether callers should pass host, url, or another field. The visible schema describes url as 'normalize or cite' and includes unrelated parameters like city, feed, json, and path, leaving the parameter contract unresolved.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific action ('Fetch'), a concrete resource ('a public robots.txt'), and a constrained output ('return group counts only'). It is immediately distinguishable from generic siblings like web-fetch or fetch-status. There is little ambiguity about the tool's core purpose.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives no when-to-use guidance and does not mention alternatives or exclusions, even though siblings such as web-fetch, normalize-url, and domain-shape overlap in URL/HTTP handling. The only usage signal is implicit in the verb, which is not enough for reliable tool routing.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the transparency burden. It does disclose that the key is discarded, suggesting a non-persistent read-only check, but it says nothing about return values, error handling, or behavior for invalid shapes, which are important for an agent invoking the tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two crisp sentences with no filler. 'Check a Jira issue key shape' is front-loaded, and 'Key discarded' adds a behavioral note, so the text is efficient even though other dimensions suffer from under-specification.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is a shape-check utility with no output schema and many optional parameters. The description does not explain what the tool returns, which parameter should receive the Jira key, or how success/failure is signaled, so the definition is incomplete for safe invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema itself documents each parameter. But the description refers to a 'Jira issue key' without mapping it to any of the nine properties, leaving the agent unable to determine which field to populate; this ambiguity outweighs the baseline benefit of full schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb and resource: checking a Jira issue key shape, which sets it apart from sibling shape tools. However, the schema contains no property for a Jira key and instead lists ref, url, city, feed, host, json, path, zone, and query, so the stated purpose is not reflected in the way the tool is invoked.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to choose this tool over alternatives such as github-repo-shape, domain-shape, or validate-json. The description implies a Jira-key use case but gives no preconditions, exclusions, or pointers to sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
lib-docs-hintCInspect
HTTP status for a public library docs URL. Body discarded.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description carries the full burden of explaining side effects and return behavior. It does disclose that the body is discarded, which is useful, but it does not say whether a network request is made, whether redirects are followed, whether authentication is needed, what errors occur, or whether this is a read-only operation. The schema-level 'discarded after check' notes are structured data and do not compensate for the lack of behavioral detail in the description.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very short and front-loads the main purpose, with the behavioral note 'Body discarded' as a second concise sentence. There is no wasted wording or filler. However, it is so terse that it sacrifices necessary context, so it is not a perfect 5.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With nine optional parameters, no annotations, no output schema, and many overlapping sibling tools, the description is not complete enough for an agent to call this tool correctly. It does not explain which parameter to pass, whether only one parameter is expected, what 'public library docs' means, or what the HTTP status response includes beyond a status code. The mismatch between the description and the schema makes the tool's intended usage genuinely unclear.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 explanation in the tool description. The description itself adds no parameter-level meaning and actually introduces potential confusion by narrowing the tool to 'public library docs URL' while the schema supports many unrelated inputs. The per-parameter descriptions are informative and self-contained, so the schema carries the parameter semantics.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a concrete behavior—returning an HTTP status for a public library docs URL—and notes that the body is discarded, so it is not a tautology. However, 'public library docs URL' is ambiguous and does not clearly map to the tool's broad input schema, which accepts city, feed, JSON, timezone, query, and other unrelated fields. It is distinguishable from fetch-status only by the 'library docs' scope, which is unexplained.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives no explicit guidance about when to use this tool versus siblings like fetch-status, browser-url-ok, normalize-url, or web-fetch. It only implies this is for 'public library docs' URLs, but it never states exclusions, alternatives, or conditions. An agent would have to guess which of the nine optional parameters to supply and how this differs from the many URL-related sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
memory-key-countBInspect
Count keys in a JSON object. Values discarded.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description is the only source of behavioral information. It does disclose a meaningful behavioral trait: values are discarded and not preserved or returned. However, it does not specify behavior for invalid JSON, error cases, or whether the operation is read-only aside from the implied counting.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences with no filler; the core operation is front-loaded and the discarded-values caveat is stated directly. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema or annotations, and the description does not explain how the JSON object is supplied, what the return value looks like, or what happens on invalid input. Given the unrelated-looking optional parameters, the description is not complete enough on its own.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents the parameters; the description adds no parameter-level meaning. It does not identify which parameter should contain the JSON object, but the high schema coverage keeps this at the baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific operation ('count keys') on a specific resource ('a JSON object'), and explicitly says values are discarded. It does not mention sibling tools or draw a distinction from validate-json or domain-shape, so it is clear but not differentiated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The second sentence implies this tool is appropriate when only the key count matters and values are not needed. There is no explicit when-to-use/when-not-to-use guidance and no alternative tool is named, so the guidance is only implicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
normalize-urlAInspect
Return origin, host, and path for a URL. Query and fragment are dropped.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden for behavioral disclosure. It clearly states that the tool returns only origin, host, and path and that query and fragment are dropped, which conveys the essential side-effect-free transformation. It does not discuss edge cases or malformed URLs, but for a simple normalization tool this is largely sufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with no filler, and the key action and output are front-loaded. Every word contributes information about what the tool does.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple URL normalization tool, the description states both the output and the transformation rule, and the schema provides a clear 'url' parameter with documentation. The main missing piece is that the description does not explicitly tell the agent that all other schema parameters are irrelevant, but this does not block correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 beyond referring to 'a URL,' which maps intuitively to the 'url' parameter. The schema itself already documents each parameter, though the description does not clarify that the many unrelated optional parameters are irrelevant to this tool.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Return') and the resource ('a URL'), and enumerates the exact outputs: origin, host, and path. It also explains what is discarded (query and fragment), which distinguishes it from sibling URL-focused tools like browser-url-ok or web-fetch.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use or when-not-to-use guidance, and no mention of alternatives. An agent must infer the tool's applicability solely from its purpose, which is not enough for clear routing among the many sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
playwright-url-okCInspect
Check whether a URL can be opened. No browser is launched.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description needs to carry behavioral disclosure. It reveals only that no browser is launched, but says nothing about whether a network request is made, side effects, errors, or return value. 'No browser is launched' is useful but insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The two sentences are terse and front-loaded, with no redundant wording. However, the tool has 9 parameters spanning heterogeneous domains, and one generic sentence is under-specified for the tool's complexity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema, no annotations, and nine optional parameters; the description only gives a purpose and one behavioral constraint. An agent would not know what result to expect, what input variants are valid, or how the params map to the check.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% parameter description coverage, so the baseline is 3. The description adds no parameter-level detail; it also fails to explain why non-URL params like city, json, zone, and query fit an 'URL can be opened' check.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a concrete action and resource: checking whether a URL can be opened. The added 'No browser is launched' distinguishes it from sibling browser-url-ok, although 'opened' could mean either HTTP reachability or syntax validity, leaving some ambiguity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance about when to prefer this tool over browser-url-ok, fetch-status, or normalize-url. The negation 'No browser is launched' hints at a lightweight check but does not name alternatives or conditions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search-query-lenBInspect
Count characters in a search query. Query discarded.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses that the query is discarded, which is useful since no annotations are provided. However, it does not clarify whether the other eight parameters are ignored, what side effects exist, or what the output 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences with no filler. The core action and the discard behavior are both front-loaded and clearly stated.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite the simple core purpose, the tool has 9 optional parameters and no output schema or annotations. The description does not resolve which parameter should be supplied, whether other parameters are valid, or what should happen when query is missing, making it incomplete for safe autonomous invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 beyond 'Query discarded,' which aligns with the query parameter description. The extra parameters remain confusing but are already documented in the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
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 characters in a search query. It is clear and not a tautology, though it does not differentiate itself from sibling counting tools like memory-key-count or hn-front-count.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives no explicit when-to-use context, alternatives, or exclusions. With 9 optional parameters and a long sibling list, it also fails to guide the agent toward the query parameter as the intended input.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description carries the full burden of behavioral disclosure. It only says the tool is a 'short catalog,' which implies a read-only reference but gives no explicit statement about side effects, return behavior, permissions, or handling of discarded inputs.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short and free of fluff, but it is under-specified rather than appropriately concise. It is a noun phrase with no actionable structure, no verb, and no framing that helps an agent decide how to invoke the tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With seven parameters, no annotations, no output schema, and a large set of sibling tools, the description is far too thin. It does not explain what inputs are expected, what the return value represents, or how this tool relates to nearby alternatives like validate-json or normalize-url.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema already documents all seven parameters with descriptions, so schema coverage is effectively 100%. The tool description adds no parameter-level meaning, but it does not mislead either, keeping this at the baseline score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'Short catalog of common HTTP status codes' is essentially a restatement of the tool name and lacks a verb or explicit operation. It does not tell an agent whether the tool looks up, validates, normalizes, or returns status codes, and it does not distinguish itself from sibling tools like fetch-status.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance about when to use this tool versus alternatives. No conditions, exclusions, prerequisites, or preferred scenarios are mentioned, and the presence of many sibling tools makes this absence particularly costly.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description carries the full burden of behavioral disclosure. It does reveal that the prompt is discarded, which is useful, but it does not say whether the input parameters are used, whether the output is fixed, or whether this operation has side effects. This is thin coverage for a tool with 9 parameters.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very short and front-loaded: the first sentence states the main purpose and the second adds a behavioral caveat. There is no filler, though the brevity borders on under-specification rather than efficient completeness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
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, the description is not complete enough for confident invocation. It does not clarify whether parameters are ignored, what the returned template contains, or how this tool should be selected among 27 siblings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema itself documents all 9 parameters. The description adds no additional parameter-level meaning beyond the schema, so the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a concrete action ('Return') and a concrete resource ('a three-step thinking template'), so the agent knows what the tool produces. It is somewhat vague about what 'three-step thinking' means and does not differentiate the tool from the many sibling tools, but the core purpose is identifiable.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 instead of the many siblings or any other approach. It does not state exclusions, prerequisites, or alternatives. The agent must infer use cases from the name and the sparse description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
timezoneAInspect
Current time in a named IANA timezone.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden of behavioral disclosure. It does state the core behavior, returning current time for a named timezone, but it does not cover invalid timezone names, response details, or whether the many unrelated 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short clause with no filler, and the most decision-relevant information—current time, IANA, named—is front-loaded. Every word contributes.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple, but the input schema contains nine optional parameters, most unrelated to timezone lookup, and the description does not clarify which one to use or that the others are ignored. The lack of an output schema also means the agent must infer enough from 'current time' alone.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the input schema already documents each parameter, including 'name' as the IANA timezone name. The description adds the 'named IANA' concept but does not explicitly map it to the `name` parameter; baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states that the tool returns the current time for a named IANA timezone, making both the operation and the resource clear. It also distinguishes itself from siblings like utc-time and iana-zones by emphasizing 'IANA' and 'named'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives no explicit guidance about when to use this tool versus alternatives, and it does not mention any sibling tools or exclusion conditions. The phrasing weakly implies that a timezone name is needed, but it does not say what to do without one or when another tool would be better.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the output but does not disclose the output format, whether the many input parameters are ignored, or any side-effect/safety profile.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, clear sentence with no filler or repetition. It is appropriately short for a simple output-returning tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite the simplicity of the stated output, the tool has eight seemingly unrelated parameters, no output schema, and no annotations. The description does not explain why these parameters exist, what format the timestamp uses, or how this tool fits with sibling tools, leaving significant ambiguity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
All eight input parameters have descriptions in the schema, so schema coverage is effectively complete. However, the description adds nothing connecting these parameters to the UTC timestamp output, and the schema itself suggests most parameters are discarded.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the expected output: a current UTC timestamp. It distinguishes the tool from a general timezone tool by explicitly saying UTC, but it does not name or contrast it with sibling tools like timezone.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance about when to use this tool versus alternatives such as timezone or web-fetch. The description only states what the tool returns, leaving the decision entirely to the agent.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
validate-jsonBInspect
Check whether a body is valid JSON. The body is discarded.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full behavioral disclosure burden. 'The body is discarded' usefully signals that the operation has no persistent effect and does not retain input. However, it does not disclose the return type, error behavior, or any limits, which are important for a validation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences deliver the core purpose and the key side effect with no filler or repetition. The most important information is front-loaded and the description is appropriately sized for such a simple tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description leaves too much unresolved: it never identifies which parameter holds the 'body', what the result looks like, or why the schema contains seven unrelated parameters. An agent would need schema inspection and inference to call this tool confidently, especially without an output schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
All seven input schema properties have descriptions, so schema coverage is high and the baseline is 3. The description adds no parameter-level meaning and does not explain how the unrelated-looking properties (ref, url, city, feed, host, path) relate to JSON validation, but it is not responsible for repeating schema details.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action ('Check whether') and target ('valid JSON'), which clearly separates it from sibling tools that validate URLs, paths, domain shapes, or Wiki titles. However, it uses the vague noun 'body' instead of naming the `json` parameter, so the tool's exact input is not fully pinned down.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance about when to use this tool versus sibling validators, no preconditions, and no mention of what kind of input is expected. The purpose implies validation, but the description never says 'use this when you need to check a JSON string' or names any alternative not to use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
weather-hintDInspect
Current temperature for a city via Open-Meteo.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are absent, so the description carries the full burden. It claims a live temperature lookup but does not disclose that the parameter descriptions say inputs are discarded, does not state whether an external call is made, and does not describe the return format. The claimed behavior is contradicted by the schema's parameter semantics.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The single sentence is tight and front-loaded, but it is under-specified rather than concise for a tool with 9 optional parameters and no output schema. It omits any mention of which parameters are relevant, so the brevity is not appropriate.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no annotations and no output schema, the description must explain return values, relevant parameters, and behavioral side effects; it does none of this. The schema's many 'discarded' parameters and the misleading weather claim leave an agent without enough information to invoke the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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; however, the description adds nothing about the eight other parameters and its one implied semantic (city is used for temperature) contradicts the schema's statement that city is 'discarded after the call'. This makes the description harmful rather than helpful for parameter selection.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a concrete result (current temperature), an input (city), and a source (Open-Meteo), so on the surface it is specific. However, it is misleading: the input schema's `city` field is described as 'discarded after the call', and no output schema or actual API behavior is described. A tool that discards the city cannot return the city's current temperature, so the stated purpose is not trustworthy.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance about when to choose `weather-hint` over siblings like `geo-hint` or `lib-docs-hint`, no prerequisites, and no exclusions. The only implied usage condition is 'need current temperature for a city', but that condition is undercut by the schema's 'discarded' note, so the guidance is effectively absent/misleading.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses a key behavior—'Body discarded'—which prevents the agent from expecting content. However, it omits error behavior, redirect handling, and the fact that many schema parameters are unused for this tool's main purpose.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with no wasted words. The core operation and the discarded-body caveat are front-loaded, making it easy to parse.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite high schema coverage, this tool has 9 parameters, no output schema, and many overlapping siblings. One line is insufficient to clarify which parameters actually apply, how the response is formatted, or how this tool differs from fetch-status and browser-url-ok.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 itself adds no parameter-level meaning, and it does not resolve the mismatch between the URL-focused purpose and the 9 mostly unrelated parameters (city, json, zone, query, etc.).
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a specific verb (fetch/return), a resource (public URL), and the result (HTTP status and content type). It clearly states the core operation, but it does not distinguish itself from sibling tools like fetch-status or browser-url-ok.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'for a public URL' implies when the tool is appropriate, but there is no explicit guidance about when not to use it or which alternatives to prefer. Sibling tools like fetch-status and browser-url-ok overlap heavily, so more routing would help.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Git ref name; discarded after the shape check | |
| url | No | HTTPS URL to normalize or cite | |
| city | No | City name for a public weather hint; discarded after the call | |
| feed | No | Public RSS or Atom URL; titles discarded | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| path | No | File path to check; no disk access | |
| zone | No | IANA timezone name | |
| query | No | Search text; discarded after the length check |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It adds one behavioral note ('Title discarded after the call') but doesn't disclose whether the tool makes network calls, requires authentication, what it returns, or any error behavior. For a likely network-bound lookup tool, this is insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with no redundant wording. The purpose is front-loaded and the discard note is additional information. It earns its place, but the extreme brevity is under-specification rather than careful conciseness, so just below a 5.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has 7 parameters, no annotations, and no output schema. The description is drastically under-specified: it doesn't explain how the parameters relate to the existence check, what the tool returns, or any behavioral details. An agent lacks the information to correctly invoke the tool. This is well below the minimum viable standard.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description refers to a 'title' but none of the seven schema parameters (ref, url, city, feed, host, json, path) represent a title. The parameter descriptions are present in the schema, but they are irrelevant to the stated purpose and do not bridge the gap. An agent cannot determine how to supply the Wikipedia title, so the description actively misleads.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action with a clear resource: 'Check whether a Wikipedia title exists.' This is a clear verb+resource statement. However, it doesn't distinguish this tool from potential siblings, and the schema mismatch (no title parameter) slightly reduces clarity, so it's not a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus alternatives, no exclusions, and no context for when the existence check is appropriate. The description only states what it does, not when to choose it.
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.
28 tool updates
- First observed
agent-tool-index - First observed
browser-url-ok - First observed
calc-eval - First observed
citation - First observed
compatibility - First observed
domain-shape - First observed
fetch-status - First observed
figma-url-shape - First observed
file-path-ok - First observed
geo-hint - First observed
github-repo-shape - First observed
hn-front-count - First observed
iana-zones - First observed
inspect-robots - First observed
jira-key-shape - First observed
lib-docs-hint - First observed
memory-key-count - First observed
normalize-url - First observed
playwright-url-ok - First observed
search-query-len - First observed
status-catalog - First observed
think-steps - First observed
timezone - First observed
utc-time - First observed
validate-json - First observed
weather-hint - First observed
web-fetch - First observed
wiki-title-ok
Frequently Asked Questions
Claiming proves that you control a remote MCP connector. It does not move, proxy, or interrupt the server.
Open the connector listing, choose Claim ownership, and sign in to Glama.
Complete one verification method:
GitHub identity – fastest for official registry listings. For a namespace such as
io.github.alice/server, link the matching GitHub user, then choose Claim with GitHub. An organization namespace such asio.github.acme/serveralso needs that organization to have installed the Glama AI GitHub App and approved its permissions, because GitHub discloses organization membership only to apps it has installed. Use HTTP or DNS when it has not.HTTP challenge – works when you can deploy a public file. Generate a token, publish the exact JSON Glama shows at
/.well-known/glama.jsonon the same origin as the connector, then choose Check HTTP challenge.DNS challenge – works when you control DNS but cannot change the server. Generate a token, create the exact TXT record Glama shows, wait for it to propagate, then choose Check DNS challenge.
After verification, Glama sends a confirmation email and gives you access to listing details, thumbnails, health checks, and analytics. Keep the HTTP file or DNS record in place: Glama periodically checks it and ownership remains verified while the token is discoverable.
The HTTP ownership file has this structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"claim": "glama_claim_..."
}Claim tokens are opaque, stable, and bound to the signed-in Glama account. They contain no email address or other personal information. If Glama can no longer discover a verified HTTP or DNS token, it starts a seven-day grace period before removing claim-based access. Restore the same token during that period to keep ownership verified. Never publish an email address, Glama session token, GitHub token, or connector credential as ownership proof.
If verification fails, confirm that you copied the current token exactly. The HTTP file must be public, return valid JSON with a successful HTTP response, and stay on the connector's origin. DNS changes may need more time to propagate. A claim cannot transfer to a different origin or hostname: if the connector target changes, Glama starts the grace period and the new target must be claimed separately after the previous claim is released.
For a connector linked to the official MCP Registry, registry updates continue to replace its name, description, and URL by default. After claiming, open Manage connector and enable Use Glama listing details as the source of truth if edits made on Glama should be preserved. Categories and thumbnails are always managed on Glama; registry linkage and technical connection settings continue to sync.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
To improve your MCP server's ranking:
Claim ownership of the server listing
Complete the server profile with an accurate description and thumbnail
Provide a test profile so Glama can connect to and evaluate the server
Keep tool definitions clear and complete to earn a high Tool Definition Quality Score (TDQS)
Route real usage through the Glama Gateway; more recorded successful server uses also improve the ranking
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!
Related MCP Connectors
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceDanish government public procurement notices (keyless).16MIT
- AlicenseAqualityDmaintenanceProvides access to Danish weather data from the Danish Meteorological Institute, enabling users to retrieve current conditions, hourly forecasts, and historical records. It supports location lookups via city names, postal codes, and coordinates for any Danish region.310MIT
- AlicenseAqualityAmaintenanceProvides access to Danish legislation from Retsinformation.dk, enabling retrieval of act metadata, full text, and recent changes with verifiable citations.4Apache 2.0
- AlicenseNot gradedqualityCmaintenanceExposes Danish public holidays and notable days to AI assistants via the Model Context Protocol, enabling queries for holidays, notable days, and holiday checks.MIT