Currency RUB
Server Details
ISO 4217 currency RUB.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
- Repository
- sadri-dridi/named-mcp-utilities
- GitHub Stars
- 0
TDQS
Scored across 28 tools
browser-url-ok and playwright-url-ok have identical descriptions, while fetch-status, web-fetch, citation, and normalize-url all overlap on URL status/metadata checking. geo-hint and weather-hint also duplicate the Open-Meteo lookup pattern, making tool selection prone to error.
Names use lowercase hyphens consistently, but conventions vary wildly: -ok, -shape, -hint, -count, and bare nouns are mixed together. There is no predictable verb_noun structure, and tools like compatibility, think-steps, and citation do not fit any coherent naming pattern.
28 tools exceeds the 25+ threshold and feels heavy for what is mostly a set of one-off validators and status probes. The server would be clearer and more navigable with roughly 10 focused tools rather than 28 loosely related helpers.
The server name 'Currency RUB' strongly implies currency functionality, yet no tool performs any currency operation or lookup. Even viewed as a general utility set, the tools only discard or validate inputs and never support complete workflows, leaving major functional gaps.
Available Tools
28 toolsagent-tool-indexAInspect
Find a public pay-per-call tool gateway (Monid). Returns CLI setup, how-it-works, skill file, and remote MCP hops. Task text discarded.
| 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 present, the description carries the transparency burden. It does disclose returned artifacts and the privacy-relevant fact that task text is discarded, and 'pay-per-call' signals external/paid behavior. It falls short on details like authentication requirements, rate limits, failure modes, or whether any side effects occur.
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 three short, information-dense sentences: the core action, the returned artifacts, and the discard behavior. There is no filler, and the most important semantic information is front-loaded.
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 lists the returned artifacts, and since all parameters are optional with full schema descriptions, a no-argument call is plausible. Still, for a tool with nine optional parameters and no output schema, it never explains how those parameters relate to the gateway lookup or when a caller should provide them, leaving a notable gap.
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 describes each of the nine optional parameters. The description itself adds only a high-level 'task text discarded' note and does not clarify how the parameters relate to the gateway lookup, 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 names a concrete action ('Find a public pay-per-call tool gateway (Monid)') and specifies what is returned: CLI setup, how-it-works, skill file, and remote MCP hops. This goes beyond the tool name and helps differentiate it from the many data-checking sibling tools, though it does not directly contrast it with any sibling.
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 implies a use case: an agent would call this when it needs a public Monid-style tool gateway or MCP hops. However, there is no explicit when-to-use/when-not-to-use guidance nor mention of alternatives among the many sibling tools, so the guidance is only implied.
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?
No annotations are provided, so the description carries the full burden. It does disclose a notable behavior—no browser is launched—but it does not mention whether a network request is made, that many parameters are discarded, or what 'opened' actually means. The schema reveals discards, but the description itself 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?
Two short sentences with no filler. The most important behavioral qualifier ('No browser is launched') appears up front, making the definition easy to scan and digest.
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 having 9 optional parameters, no annotations, and no output schema, the description is only one sentence. It does not explain return values, side effects, or how the many unrelated-looking parameters (city, ref, json, query) relate to checking a URL. An agent would need to inspect the schema and sibling tools to use it 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 all 9 parameters are already documented with their own descriptions. The tool description adds no parameter-level meaning beyond the schema, so the baseline of 3 applies.
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?
Description states a specific verb and resource ('Check whether a URL can be opened') and adds a key distinguishing note that no browser is launched, which helps separate it from playwright-url-ok. However, 'opened' is ambiguous—it could mean an HTTP fetch, a shape check, or a routing check—so it stops short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool instead of siblings like playwright-url-ok, fetch-status, or normalize-url. The only hint is 'No browser is launched,' which implies a lighter-weight check, but there are no stated conditions, exclusions, or alternative tool names.
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, the description carries the full burden of behavioral disclosure, but it only says 'Expression discarded,' which is confusing because no expression parameter exists. It does not explain what is returned, whether side effects occur, how other parameters are handled, or what happens on invalid input.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The text is short and front-loaded, so it earns some credit for conciseness. However, it is under-specified for a tool with nine parameters and a non-obvious purpose; the second sentence references a nonexistent input and therefore does not earn 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?
The description is severely incomplete for a tool with this schema complexity and sibling context. It fails to state how the expression is provided, what the output is, when to prefer this tool over siblings like validate-json, normalize-url, weather-hint, or file-path-ok, and what behavioral guarantees exist.
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, but the description adds no useful parameter semantics and actually introduces an 'expression' concept absent from the schema. The nine documented parameters have clear individual descriptions, yet none of them is connected to 'a+b style arithmetic,' leaving the agent unable to construct a correct invocation.
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 claims the tool evaluates 'a+b style arithmetic', but the input schema contains nine unrelated optional parameters (ref, url, city, feed, host, json, path, zone, query) with no way to supply an arithmetic expression. This is misleading rather than clarifying: an agent cannot determine what resource is actually operated on or how the advertised purpose maps to the schema.
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 any sibling tool. Given the abundance of similar validation/shape-checking sibling tools, the description offers no exclusions, alternatives, or context to help an agent select this tool correctly.
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?
With no annotations provided, the description carries the transparency burden. It discloses return fields and a non-storage guarantee, but does not mention error behavior, ignored parameters, or any side effects beyond not storing content.
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, front-loaded with the action and output, with no redundant words.
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 promise, the context includes 9 optional parameters and no output schema, and the description does not clarify which parameters are relevant or how to invoke the tool correctly. It is not complete for an agent facing this ambiguous 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?
The schema descriptions cover all 9 parameters, but the top-level description adds no parameter meaning and does not map 'URL' to the url property. Since schema coverage is high, this is acceptable but not improved by the description.
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 tool returns host, scheme, and HTTP status for a URL and explicitly says page content is not stored. It could be more specific about which sibling tools it complements, but the core purpose is understandable.
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 given about when to choose this tool over siblings like fetch-status or normalize-url. The only additional statement is a non-storage guarantee, which is behavioral rather than usage direction.
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?
The description and parameter details disclose positive behavioral facts: no identifiers are retained, inputs are discarded after checks, and path checking does no disk access. However, it does not mention side effects, external calls, error behavior, or whether the tool is strictly read-only.
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 redundant text. The single sentence earns its place, though the brevity does sacrifice useful context.
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 explanation of what the classification result looks like, what categories exist, or how the inputs are evaluated. For a tool with nine parameters, the description is far too incomplete for an agent to use reliably.
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 descriptions, so schema coverage is complete. The descriptions mostly emphasize disposal behavior rather than how each value contributes to classification, but they do provide basic semantic labels like 'Git ref name' and 'HTTPS URL to normalize or cite.'
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 'Show how this request is classified' but never defines what 'this request' is or what classification means. With nine heterogeneous parameters and no output schema, the actual purpose remains ambiguous.
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 the many sibling tools such as normalize-url, validate-json, domain-shape, or fetch-status. The description does not explain conditions, prerequisites, or alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
domain-shapeBInspect
Split a hostname into labels without WHOIS or ownership data.
| 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 only mentions hostname splitting but the schema includes many unrelated parameters (city, feed, json, etc.) with no explanation of how they interact or are ignored. This lack of disclosure about parameter handling makes the tool's behavior opaque and potentially misleading.
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, concise sentence that directly states the core function and a key exclusion. No unnecessary words or repetition.
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 fails to account for the majority of parameters in the schema, creating a mismatch. It does not explain what happens to parameters like 'city' or 'json', leaving the tool's full context incomplete. The lack of an output schema or error handling notes further reduces completeness.
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 descriptions already cover all 9 parameters (100% coverage), so the tool description adds minimal value. It clarifies the overall purpose but does not explain relationships or which parameter is the primary input, meeting the baseline for high 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 clearly states the tool's primary action ('Split a hostname into labels') and explicitly excludes WHOIS/ownership data, making its purpose distinct and straightforward. It aligns well with the tool name 'domain-shape'.
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 provides no explicit guidance on when to use this tool versus alternatives, though the phrase 'without WHOIS or ownership data' hints at a limitation. It does not mention scenarios where this should be preferred or avoided, leaving the agent to infer usage from the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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?
With no annotations, the description carries the burden of disclosing behavior; it does state the HTTP method, the public-scope requirement, and that only status is returned. It does not explain how the many non-URL parameters are handled or what happens on redirects or errors, though the schema's parameter notes add some discard behavior.
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 concise and front-loaded, but it is under-specified for a tool with nine optional parameters and no output schema. It is not bloated, yet it leaves the agent to discover the schema's full 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?
The tool is complex: nine heterogeneous optional parameters, no annotations, and no output schema. The description only covers URL checking and gives no indication of what statuses are returned, which parameters are valid together, or why city, JSON, timezone, and search query inputs belong in the same 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?
Schema description coverage is 100%, so the schema already documents all nine parameters; the description adds no parameter-level meaning. The schema notes like 'discarded after the check' are helpful, but the description itself does not clarify which parameter or combination should be supplied.
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 HTTP verb (HEAD), a target (public URL), and a narrow output (status only), so the basic action is clear. It does not explicitly distinguish it from siblings like web-fetch or browser-url-ok, and it only describes one of the nine schema parameters.
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 web-fetch, browser-url-ok, normalize-url, or the shape-checking siblings. The phrase 'status only' weakly implies a lightweight check, but it never states when this tool should or should not be chosen.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
figma-url-shapeBInspect
Parse a Figma file URL. Path discarded.
| 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 burden of behavioral disclosure. 'Parse' suggests a read-only, non-destructive operation, and 'Path discarded' at least signals that one input is ignored after the check. But it does not clarify whether any network access occurs, what is returned, or whether there are side effects, leaving notable ambiguity.
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 extremely short and front-loads the main purpose in the first sentence. The second sentence, 'Path discarded,' is concise but cryptic, and could confuse an agent about which path is meant. Still, no words are wasted and the structure is simple.
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, nine optional parameters, and no required fields, the description is not sufficient for confident invocation. It does not state which parameter should carry the Figma URL, what the shape-check output looks like, or how this tool fits among the many sibling utilities. The agent would likely need to open the schema and infer behavior from the generic parameter descriptions.
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 all nine parameters. The description adds no new parameter-level meaning beyond the mention that the path is discarded, which the schema already states for the path 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 uses a specific verb ('Parse') and a clear resource ('Figma file URL'), and the tool name reinforces the domain, distinguishing it from siblings like normalize-url or github-repo-shape. It is slightly ambiguous what 'Parse' produces and whether 'Path discarded' refers to a URL component or an input parameter, 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 implies usage is for Figma file URLs, which is a reasonable trigger for an agent. However, it gives no explicit guidance about when to use this tool instead of sibling URL-related tools like normalize-url, browser-url-ok, or playwright-url-ok, nor any exclusions.
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, the description must carry behavioral disclosure; it does state that the tool performs no disk access, which is useful and non-obvious. However, it does not explain whether 'safe' means rejecting traversal or absolute paths, what the return value is, or whether input is otherwise read or validated.
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 and the most important safety property are front-loaded. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
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 and no output schema or annotations, this is too thin. The description does not clarify which parameter should be passed, what 'safe' means, what result the agent should expect, or why the schema exposes unrelated fields like url, city, and json.
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 semantics beyond naming 'path', while the schema already documents each of the nine optional properties, including path.
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 ('check') and resource ('path') and adds a defining boundary ('No disk access'). It distinguishes this from sibling URL/title/key-shape tools, though 'looks safe' leaves the exact validation criteria unspecified.
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 explicit when-to-use guidance or comparison to siblings such as browser-url-ok or wiki-title-ok. 'No disk access' implies it is a pure shape check rather than a filesystem probe, but the description does not say when to choose it over alternatives.
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?
The description does not disclose side effects, data handling, or retention policies. While the parameter descriptions mention that some values are 'discarded after the call', the tool description itself lacks transparency about what happens to inputs or outputs.
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, concise sentence that directly states core functionality. It avoids unnecessary detail while communicating the essential purpose.
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 the large, heterogeneous schema with nine unrelated parameters, the minimal description fails to provide enough context to correctly invoke the tool. It does not explain which parameters are relevant, how they relate, or what the expected output format is, making the tool difficult to use without additional inference.
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 schema has 100% parameter coverage, but the parameter descriptions are inconsistent with the tool's stated purpose (e.g., 'city' for a weather hint, 'query' for a length check). The description does not clarify which parameter actually represents the 'place', so semantics remain unclear despite the high 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 states that the tool returns latitude and longitude for a place via Open-Meteo, which is a specific verb and resource. However, it does not differentiate from sibling tools like weather-hint, and the schema includes many unrelated parameters, so the core purpose remains ambiguous.
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 on when to use this tool versus alternatives. It simply describes functionality without any conditional or comparative cues, leaving the agent without direction on appropriate invocation contexts.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
github-repo-shapeAInspect
Parse owner and repo from a GitHub URL.
| 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 only states that parsing occurs; it does not mention what happens with invalid URLs, whether the tool returns an error, whether it fetches network data, or what the output structure 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?
A single clear sentence with no filler. The core action and target resource are front-loaded, making the purpose immediately understandable.
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 and no annotations, the description should explain what the tool returns and how the many optional parameters are treated. It does not mention return values, error behavior, or why multiple unrelated parameters are accepted.
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%, but the description adds important meaning by clarifying that the 'url' parameter should be a GitHub URL, which the schema alone does not explicitly state. This helps an agent select the correct parameter among the nine properties.
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 ('Parse') and names the exact resource ('owner and repo from a GitHub URL'). This clearly distinguishes it from sibling URL-related tools like normalize-url 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 description implies the tool should be used when an agent needs to extract owner and repo from a GitHub URL. It provides clear context but does not explicitly mention alternatives or state when not to use the tool.
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?
With no annotations, the description carries the behavioral burden. It discloses that titles are not returned, which is a meaningful behavioral trait, but it does not describe the return format, data source freshness, network dependence, or failure behavior.
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 extremely concise: two short sentences with no filler. The core purpose is front-loaded, and 'Titles discarded' adds a useful behavioral clarification without bloating the text.
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 nine optional parameters and no output schema, yet the description does not explain whether any parameters affect the count, which ones are relevant, or what the return value looks like. This leaves significant ambiguity for an agent deciding how 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 schema already documents the nine parameters. The tool description adds no parameter-specific guidance, but because the schema is complete, the baseline of 3 applies.
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, 'Count', and a specific resource, 'current Hacker News front-page stories'. 'Titles discarded' clarifies the output is a count rather than story content, and there are no sibling tools with a similar 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 implies when to use the tool: when a count of current Hacker News front-page stories is needed. However, it does not explicitly name alternatives or state when not to use it beyond the hint that titles are discarded.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
iana-zonesCInspect
Common IANA timezone names for clock calls.
| 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 explaining behavior, but it only states that some names exist 'for clock calls.' It does not disclose whether the tool returns a list, performs validation, or has any side effects, nor does it explain the 'discarded after the shape check' behavior hinted at in the schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short with no filler, which is good for conciseness, but it is a sentence fragment and lacks the structure needed to convey an action or return value. It is not appropriately sized for a tool with nine parameters and 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?
The definition is severely incomplete for a tool with nine optional parameters, no output schema, no annotations, and overlapping siblings. An agent is given no information about what to pass, what the tool returns, or how it differs from timezone/utc-time, so it cannot reliably select or invoke the tool.
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 fully documents all nine parameters, including notes that several are discarded after checks. The description adds no parameter-level meaning beyond this baseline; it does not clarify which parameter is primary or how the 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 names a specific resource ('Common IANA timezone names') and a purpose ('for clock calls'), but it is a noun phrase without a verb, so it does not state what the tool actually does (returns a list, validates, or something else). It adds the qualifier 'common' and the clock context, moving it beyond a pure tautology, but it still leaves the operation ambiguous.
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 when-to-use or when-not-to-use guidance is provided, and no alternatives are named despite sibling tools like timezone and utc-time that clearly overlap in the clock/time domain. The phrase 'for clock calls' gives only a general domain hint, not enough to choose this tool over its siblings.
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?
No annotations are provided, so the description carries the transparency burden. It does disclose a network read ('fetch public') and 'group counts only' tells the caller the output is deliberately limited. However, it is silent about error behavior, what happens when no parameter is supplied, and what concrete counts are returned.
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 sentence, no filler, and the action ('Fetch a public robots.txt') is front-loaded; the output limitation follows immediately. 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?
With nine optional parameters, no annotations, and no output schema, a one-sentence description is not enough to call the tool reliably. Missing details include which parameter is the robots URL, whether any input is required, and the exact form of the returned group counts; the schema descriptions actively confuse rather than clarify.
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 schema descriptions describe unrelated concerns (weather hints, timezone names, JSON validation, discarded values) and never connect any parameter to robots.txt. The description does not bridge that gap, so an agent cannot tell whether to use 'url' or 'host' as the fetch target.
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 resource ('public robots.txt') and an action ('fetch'), and restricts the result to 'group counts only,' which signals a summarized output rather than full content. It does not explicitly distinguish sibling fetch tools, but the scoping phrase gives it enough identity.
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/when-not-to-use guidance, no prerequisite, and no alternative tool is named. With zero required parameters, the agent is also not told what input is expected, so the description gives no direction on how to invoke this instead of web-fetch or fetch-status.
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 provided, the description bears the full burden of behavioral disclosure. The statement 'Key discarded' hints that the input is not persisted, but there is no mention of whether the tool makes network calls, whether it only validates locally, or what it returns. The behavioral information is too thin to be reliable.
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 contains no filler, which is concise, but it is under-specified to the point of losing utility. 'Key discarded' is a useful note, yet the overall structure provides no how-to context and leaves too much unstated.
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 a large and heterogeneous input schema with no output schema and no annotations. The description does not state which input is the Jira key, what 'shape' means, what the result looks like, or when this tool should be preferred. An agent cannot reliably select or invoke this 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?
The schema's parameters each have their own descriptions, giving high schema coverage. The tool description adds no parameter-level meaning, and importantly it fails to identify which parameter represents the Jira key, so the agent must guess among ref, text, id, or path. The baseline of 3 applies since the schema already documents the parameters reasonably.
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: 'Check a Jira issue key shape.' However, it never defines what a valid shape is, and the input schema contains many unrelated parameters like url, city, feed, and json with no indication of which one carries the Jira key. This ambiguity makes the purpose only vaguely 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?
There is no guidance on when to use this tool versus siblings like github-repo-shape, figma-url-shape, or domain-shape. No alternatives, exclusions, or contextual triggers are mentioned, leaving the selection entirely to the agent.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
lib-docs-hintBInspect
HTTP status for a public library docs URL. Body discarded.
| 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 behavioral burden; it does disclose that the tool returns HTTP status and discards the body, which is meaningful. However, it does not explain how the other schema fields (ref, city, feed, host, json, path) behave, or whether they are ignored for a library-docs URL check.
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 names the core function and the second adds the key limitation. Every word earns its place and there is no 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?
For a tool with no annotations, no output schema, and a broad nine-parameter schema, two sentences are inadequate. It does not specify the return format, which parameter to populate for a docs URL check, or the role of the other parameters, and the description's 'library docs URL' scope conflicts with the schema's generic 'normalize or cite' url 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?
Schema description coverage is 100%, so the baseline is 3; the description adds only a 'public library docs URL' context that is not present in the generic url parameter description. It contributes no semantics for the other parameters and may mislead an agent into thinking only url matters.
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 output ('HTTP status') and a specific resource ('public library docs URL'), plus a useful behavioral note that the body is discarded. It is clear, though it does not distinguish this tool from sibling status/URL tools such as 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?
No guidance is given on when to use this tool instead of alternatives like fetch-status, web-fetch, or normalize-url. The only implicit clue is 'Body discarded,' but no when-to-use or when-not-to-use context is provided, and the nine optional parameters are never mapped to scenarios.
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 carries the full burden. It does disclose a meaningful behavioral trait: 'Values discarded.' However, it does not explain what output is returned, whether the tool-call arguments themselves are the JSON object counted, or how optional parameters affect the result. This is partially transparent but incomplete.
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 extremely concise—two short sentences with no filler. 'Count keys in a JSON object' is front-loaded and direct. The brevity is a strength, though it sacrifices some necessary context.
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?
This tool has nine optional parameters, no required parameters, no annotations, and no output schema. The description does not explain how to construct the JSON object to count, whether empty calls are valid, or what the response represents. It is too sparse to be fully usable without additional inference.
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 general principle that values are discarded, which is useful. But it does not clarify how the nine parameters relate to the 'JSON object' being counted, and some parameter descriptions suggest unrelated behaviors like normalizing URLs or weather hints.
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 in a JSON object'—and clarifies that values are not used. This is not a tautology of the tool name. However, it does not explicitly distinguish itself from siblings or specify whether the JSON object is the tool-call arguments or a value in the 'json' parameter.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 like validate-json or search-query-len. The description does not mention conditions, exclusions, or related tools. A minimal 'when you need to count keys' implication exists, but no real usage guidance is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
normalize-urlBInspect
Return origin, host, and path for a URL. Query and fragment are dropped.
| 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 query and fragment are dropped, which is a useful behavioral trait. However, with no annotations and a complex schema, it does not clarify whether the tool performs network access, validates the URL, or ignores unrelated input fields.
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 concise and front-loaded, with the main purpose stated first and a useful behavioral qualifier in the second sentence. It could have used one more clause to address the unusual parameter list, but it is efficiently written.
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 the nine-parameter schema, no annotations, no output schema, and a family of URL-related sibling tools, the description is too minimal. It does not specify the return format, which parameter to populate, or how to handle the many apparently irrelevant input fields.
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, but the input schema contains many parameters that appear unrelated to URL normalization, such as city, feed, json, and zone. The description does not identify `url` as the primary/only meaningful parameter or explain that the other fields are discarded, leaving the agent without necessary disambiguation.
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: it returns origin, host, and path for a URL. It also adds a concrete behavioral detail, dropping query and fragment, which distinguishes it from URL-checking or fetching tools like browser-url-ok and 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?
The description implies the tool should be used when a URL's origin, host, or path is needed, but it does not explicitly state when not to use it or mention alternatives. There is no direct comparison to sibling tools such as fetch-status or citation.
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 carries the full burden of disclosing behavior. It mentions that no browser is launched, but omits whether it makes a network request, follows redirects, uses timeouts, or what side effects may occur.
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 direct, with no filler. It front-loads the core purpose and adds one non-obvious behavior, though it could include more detail without becoming verbose.
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, so the description should indicate the return value, such as a boolean or status. It also fails to explain whether the URL parameter is required or how the many other schema parameters relate to the operation.
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 tool description does not add meaningful information about which of the nine optional parameters matter, and several schema descriptions appear irrelevant 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 clearly states the action ('Check whether a URL can be opened') and the resource ('URL'). However, it does not differentiate this from sibling tools like browser-url-ok or fetch-status, so it is clear but not fully distinguishing.
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 instead of alternatives such as browser-url-ok, fetch-status, or web-fetch. The only contextual hint is 'No browser is launched', which does not explain appropriate usage.
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?
With no annotations provided, the description carries the full burden. It does disclose a behavioral trait: `Query discarded`, indicating the query is not stored or persisted. However, it does not specify the return format, whether other parameters are ignored, or any other side effects, leaving notable gaps for a tool with no annotation support.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise and front-loaded: it states the action first and the disposal behavior second. It earns its two short sentences, though the brevity leaves the multi-parameter schema underspecified; that is more a completeness issue than a conciseness issue.
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 9 optional parameters, no required fields, no output schema, and no annotations. The description does not tell the agent which parameter to supply, whether multiple parameters can be counted, or what the result looks like. An agent could easily pass the wrong parameter or no parameter and unknowingly get a meaningless result.
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 all nine parameters and their discard behavior. The description adds no additional parameter meaning beyond restating that the query is discarded, which mirrors the schema's `query` parameter description.
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 (`Count characters`) and resource (`a search query`), which is clear and differentiates the core purpose from siblings like `validate-json` or `normalize-url`. However, it does not explicitly distinguish it from other counting tools such as `memory-key-count` or `hn-front-count`, and the 9-parameter schema introduces ambiguity about which resource is actually counted.
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 instead of alternatives, no mention of required inputs, and no exclusions. The agent must infer from the name and the query parameter description that this is for measuring a search query's length, which is not explicitly stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
status-catalogDInspect
Short catalog of common HTTP status codes.
| 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. The single phrase 'short catalog' implies a read-only reference, but it does not describe side effects, network access, what happens to the inputs, whether any of them are discarded, or what the return value looks like. Some parameter descriptions mention discarded values, but that is in the schema, not the tool description, and an agent reading only the description would remain completely in the dark.
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 concise (6 words), but that is under-specification, not efficient conciseness. It lacks any structure or front-loaded details that would help an agent understand the tool's purpose or usage. Every word is present, but none of them are informative enough to guide correct invocation.
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 8 parameters, no output schema, no annotations, and unclear relationship to its siblings, the description is grossly incomplete. It does not explain how the catalog is queried, what the output format is, or why parameters like 'city' and 'feed' appear in an HTTP status code catalog. An agent cannot reliably select or call this tool based on the given definition.
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 contains descriptions for all 8 parameters (ref, url, city, feed, host, json, path), so schema coverage is high. The description itself adds no parameter information, but per the baseline rule, a 3 is appropriate when the schema already documents the parameters.
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 a noun phrase with no verb—it does not state what action the tool performs (e.g., returns, lists, looks up). It names a resource (HTTP status codes) and a kind (catalog), but this is largely a restatement of the tool name. The presence of 8 unrelated input parameters (ref, url, city, feed, host, json, path) further muddies what the tool actually does, and it does not differentiate from sibling tools like fetch-status or web-fetch.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus any of the siblings. There is no mention of conditions, alternatives, or exclusions. An agent would have no basis to choose this tool over fetch-status, web-fetch, or normalize-url, which all deal with URLs/HTTP in some form.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
think-stepsBInspect
Return a three-step thinking template. Prompt discarded.
| 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 behavioral disclosure burden. It does reveal an important trait: 'Prompt discarded.' However, it does not clarify whether the output is always identical, whether any parameter affects the result, or what error behavior 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 primary behavior is front-loaded and the important caveat about the discarded prompt is stated immediately.
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 and the schema covers inputs, but with no annotations and no output schema, the description could be more complete. It does not give an example of the returned template or explicitly state that all inputs are ignored beyond the prompt.
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, including their discard behavior, so schema coverage is high. The description adds no parameter-specific meaning beyond the schema, so the baseline score of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a concrete action and deliverable: 'Return a three-step thinking template.' It is specific enough to distinguish this tool from the sibling validators and fetch utilities, though it does not explicitly name a sibling alternative.
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 given for when to use this tool versus alternatives. The name implies a thinking-template use case, but the description provides no context, prerequisites, or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
timezoneBInspect
Current time in a named IANA timezone.
| 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 exist, so the description carries the burden. It clearly implies a read-only lookup with no destructive effects, which is adequate for a simple time tool. However, it does not disclose behavior for invalid timezone names, output format, or that most schema parameters are discarded beyond what the schema already says.
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 sentence with no filler, front-loading the essential operation. It earns its place and does not waste tokens.
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 definition leaves important invocation details ambiguous: required parameters are 0, yet the description implies a timezone must be provided; there is no output schema; and the presence of many unrelated accepted parameters is confusing without a clear statement that only 'zone' matters. An agent cannot fully predict the call contract from the description and schema 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 schema already documents each parameter. The description adds little beyond restating that an IANA timezone name is used, which mirrors the 'zone' parameter's schema description. The 'discarded' notes in the schema are useful but are not part of the description.
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: 'Current time in a named IANA timezone.' This makes the core purpose unmistakable and distinguishes it from related concepts. It doesn't explicitly differentiate from siblings like utc-time or iana-zones, but the meaning is still 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 phrase 'named IANA timezone' implicitly suggests this tool is for zone-specific local time rather than UTC time, but there is no explicit when-to-use or when-not-to-use guidance. The agent must infer the choice among siblings like utc-time and iana-zones without direct routing help.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
utc-timeBInspect
Current UTC timestamp.
| 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 information. Some parameter descriptions disclose that values are discarded or that no disk access occurs, but the overall behavior is still unclear and not all parameters are explained consistently.
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 that is appropriately concise. Every word contributes to the stated purpose.
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 minimal description does not explain how the nine optional parameters relate to the tool, why they are accepted, or what output format is returned. Given the schema complexity, the tool context is 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?
Although the schema descriptions cover all parameters, they are largely irrelevant to a UTC timestamp tool and appear to be decoys. Several descriptions imply unrelated behaviors such as normalization, validation, or length checks without explaining how they affect the output.
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 'Current UTC timestamp.' clearly identifies the tool's output and is easy to distinguish from sibling time-related tools. It lacks an explicit verb, but the intent is unambiguous.
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 explicit guidance on when to use this tool instead of alternatives. The purpose is clear, but no usage conditions, exclusions, or references to sibling tools are provided.
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?
The description discloses a key behavioral trait: 'The body is discarded.' With no annotations provided, it takes on the burden of transparency, but it does not describe the return value (boolean vs. error) or how other input parameters are treated beyond the schema descriptions. It adds some value but leaves important behavioral details to 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?
Two sentences with zero filler: first states purpose, second states the discard behavior. Every word earns its place and the most important information is front-loaded.
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 a large schema with many unrelated parameters, but the description doesn't clarify that only 'json' is used and others are ignored/discarded. The term 'body' is inconsistent with the actual parameter name 'json', which could confuse an agent about required inputs. No output schema or additional context is provided to fill the gap.
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 schema descriptions already cover all parameters, including the key 'json' field. The tool description adds no new parameter-level semantics, and the word 'body' doesn't map directly to any schema property. Baseline of 3 is appropriate given the high schema description 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?
States a specific verb and resource ('Check whether a body is valid JSON') that clearly differentiates it from sibling shape/URL validators. The purpose is immediately unambiguous even without reading the schema.
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 on when to use this tool over alternatives, and no explicit exclusions or prerequisites. The only contextual signal is the obvious implication that it is for JSON validation, which doesn't help an agent decide among sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
weather-hintBInspect
Current temperature for a city via Open-Meteo.
| 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 reveals that an external Open-Meteo lookup will occur, which is useful behavioral context. However, with no annotations, it does not disclose the response format, failure behavior, or that the remaining eight schema parameters are effectively inert for this 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 a single front-loaded sentence with no filler. Every word contributes to the core meaning, and there is no redundant restating of the tool name or input schema.
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 the unusually broad 9-parameter schema, no output schema, and no annotations, the description is too thin. It does not clarify which parameter to actually pass, what the response contains, or that all unrelated parameters should be left out, leaving significant room for misinvocation.
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 every parameter, including which values are discarded. The description adds little beyond naming 'city' as the relevant input, but the schema carries the semantic load, so a 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 uses a specific verb and resource: it reports the current temperature for a city via Open-Meteo. This clearly distinguishes the tool from siblings like geo-hint or utc-time, and the one-sentence definition is unambiguous.
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 given for when to use this tool versus alternatives, nor does it state that only the 'city' parameter should be supplied while the other eight accepted parameters are ignored. The agent is left to infer both the selection context and the actual input pattern.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
web-fetchAInspect
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 burden of behavioral disclosure, and it does disclose a key behavior: the body is discarded after the request. It also narrows scope to public URLs, implying no authentication. It could mention error handling or redirect behavior, but the main side effect is exposed.
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, front-loaded sentences with no filler. The essential output and the key behavioral constraint are stated immediately and clearly.
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 names the core return values and the main discard behavior, which is sufficient for the central use case. However, with 9 optional parameters and no output schema, it does not clarify how the other parameters relate to the tool's purpose, though the schema descriptions partially compensate.
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 all parameters. The description adds only the public-URL/body-discarded framing, not extra parameter-level meaning, 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 clearly states the tool returns HTTP status and content type for a public URL and that the body is discarded. This is specific about the resource and outcome, though it does not explicitly differentiate 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 'Body discarded' implies the tool is appropriate when only status/content type is needed, not when the response body is required. However, it gives no explicit when-to-use guidance or named alternatives, leaving the agent to infer selection among similar siblings.
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?
Annotations already declare readOnly=true and destructive=false. The description adds the note 'Title discarded after the call,' giving extra context about resource lifetime. This is useful but modest; it does not reveal return behavior or error conditions, and the annotation profile already covers the main safety attributes.
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, front-loaded with the primary purpose and immediately followed by the resource-disposal note. Every word earns its place with no redundancy or 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?
The description omits the essential mapping between the tool's purpose and its input schema. With no output schema and multiple unrelated-looking parameters, an agent cannot reliably construct a valid call. The discard note is the only behavioral detail, and no return value or error semantics are described.
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 does not explain which of the seven schema parameters corresponds to the Wikipedia title. The schema properties (ref, url, city, feed, host, json, path) have generic 'discarded after the shape check' descriptions that appear unrelated to Wikipedia titles. There is a critical mismatch between the tool's stated purpose and its input contract, leaving an agent unable to determine what to pass.
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: 'Check whether a Wikipedia title exists.' This clearly conveys what the tool does. It does not explicitly distinguish it from sibling tools like browser-url-ok or github-repo-shape, so it falls one point short of top marks.
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. The description does not mention prerequisites, exclusions, or related sibling tools. An agent must infer entirely from the tool name and task context when this should be invoked.
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
- AlicenseAqualityAmaintenanceEnables querying Central Bank of Russia data including daily currency rates, exchange rate dynamics, key rate and history, precious metals prices, and currency conversion, with no authorization required.7671MIT
- AlicenseAqualityAmaintenanceCentral Bank of Russia (CBR) data for AI agents — daily and historical currency rates, key rate, inflation, and macro statistics. Five typed MCP tools, in-memory TTL cache, MIT-licensed, no API key required.52MIT
- AlicenseAqualityDmaintenanceProvides real-time currency exchange rates for USD and EUR against the Russian Ruble, along with Brent crude oil prices sourced from zenrus.ru. It includes tools for fetching live financial data and calculating oil purchasing power based on current market rates.11MIT

UniRate MCPofficial
AlicenseAqualityCmaintenanceCurrency conversion and exchange rates for AI assistants. 170+ currencies, historical data back to 1999.435MIT