URL host only
Server Details
URL host only
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
- Repository
- sadri-dridi/named-mcp-utilities
- GitHub Stars
- 0
Available Tools
11 toolscitationCInspect
Return host, scheme, and HTTP status for a URL. Page content is not stored.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | HTTPS URL to normalize or cite | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| zone | No | IANA timezone name |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden, and it does disclose one meaningful behavioral trait: 'Page content is not stored.' This is a useful privacy guarantee. However, it does not disclose whether the URL is actually fetched live, whether rate limits apply, whether the request follows redirects, or what happens on failure (e.g., invalid URL, timeout). The single behavioral statement is valuable 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 compact and front-loaded, with the primary purpose in the first sentence and a behavioral caveat in the second. Every sentence earns its place. It loses one point because the tool name 'citation' does not match the description's focus, which could confuse parsing, and the description is almost too minimal to be genuinely useful.
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 4 parameters, no annotations, and no output schema, the description should explain more about how the tool behaves, what constitutes valid input, and what the return shape is. The one-sentence description plus a privacy note is insufficient for an agent to confidently invoke this tool in a real workflow. Sibling tool names suggest overlapping functionality, but no disambiguation is provided.
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 four parameters. The description adds minimal meaning beyond the schema, but the schema covers the heavy lifting. The described output ('host, scheme, HTTP status') aligns with the `url`, `host`, and `status` parameters, and the description's phrase 'normalize or cite' helps contextualize the URL parameter. Since coverage is complete, a baseline of 3 applies, and the small extra context warrants a 4.
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 ('Return') and resource ('host, scheme, and HTTP status for a URL'), so an agent can infer the core function. However, the tool is named 'citation' yet the description is about URL fetching, which creates ambiguity about the intended use. It does not distinguish itself from the sibling tools like normalize-url or validate-json beyond listing a few outputs.
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 versus siblings such as normalize-url, validate-json, or status-catalog. The description implies a URL-checking purpose but does not state what scenarios it is appropriate for, what prerequisites exist (e.g., URL reachability), or when a sibling would be a better choice. This leaves the agent to guess.
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 |
|---|---|---|---|
| url | No | HTTPS URL to normalize or cite | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| zone | No | IANA timezone name |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the behavioral disclosure burden. It does disclose one useful behavior: 'No identifiers are retained.' However, it does not explain whether the operation is read-only, what processing happens, or what the output looks like. The privacy note is helpful but incomplete for safe invocation.
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, with no filler words. However, the brevity comes at the cost of clarity: the first sentence is too vague to be useful, and the second sentence provides only a privacy detail. This reads as under-specification rather than efficient compression.
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 explain what classification means or what the tool returns, but it does not. With four optional parameters and no required inputs, an agent also needs guidance on which inputs are relevant and whether they can be combined. The description is not complete enough for reliable tool selection.
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 explains the meaning of url, host, json, and zone. The description does not add any relationship or ordering between these parameters, so it offers no bonus value. A baseline of 3 is appropriate because the schema does the heavy lifting.
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,' which names a verb and an object but leaves the central term 'this request' undefined. It does not state what is being classified or how that relates to the tool name 'compatibility' or the four input fields. It is vague rather than a pure tautology, but it does not clearly differentiate the tool from siblings.
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 about when to use this tool versus any alternative. It does not mention sibling tools such as validate-json, normalize-url, or timezone, nor does it explain which input scenarios call for compatibility. An agent is left to guess when this tool is appropriate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
domain-shapeBInspect
Split a hostname into labels without WHOIS or ownership data.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | HTTPS URL to normalize or cite | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| zone | No | IANA timezone name |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description is the sole source of behavioral context. It discloses that no WHOIS/ownership lookup is performed, which is a genuine behavioral exclusion. However, it does not mention edge-case handling such as invalid hostnames, trailing dots, or IDN normalization, nor what the returned label 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?
The description is a single sentence with no filler. The verb is front-loaded and the scope qualifier is concise. Any missing information is a content gap, not a structure or conciseness problem.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no annotations and no output schema, the description must carry full context, but it does not specify which input parameter should be used, what the output format is, or what the unrelated url/json/zone parameters mean for this tool. An agent would likely be uncertain whether to pass host or url, making the definition incomplete for reliable invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so each parameter is already documented in the schema and the baseline is 3. The description adds no parameter-level detail and does not tell the agent which input field is relevant for the hostname split, but it does not contradict the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('split') and resource ('hostname into labels') and adds a scope qualifier ('without WHOIS or ownership data') that distinguishes it from enrichment-style domain tools. It is clear what the core operation is, though it does not explicitly differentiate from closely related siblings like url-host or normalize-url.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The 'without WHOIS or ownership data' clause implies a local, syntactic operation and suggests when not to use it, but it does not name alternative tools or specify when to choose this over url-host or normalize-url. It also does not clarify whether the hostname should be supplied via the 'host' or 'url' parameter.
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 |
|---|---|---|---|
| url | No | HTTPS URL to normalize or cite | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| zone | No | IANA timezone name |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full behavioral burden. It weakly suggests the tool returns common IANA timezone names, but it does not disclose output format, side effects, filtering behavior, or how the four optional parameters affect the result. This is a significant transparency gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with no filler, but it is under-specified for a tool with four optional parameters, no annotations, and no output schema. Brevity here comes at the cost of actionable guidance, making it closer to under-specification than effective conciseness.
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 and no output schema, this description is incomplete. It does not explain whether the tool accepts arguments, what it returns, how it relates to siblings like timezone and utc-time, or why url, host, and json are in the schema. The description is too thin to allow confident correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents each parameter's meaning. The description adds a clock-call context for zones but does not clarify the relationship between the zone parameter and the unrelated-looking url, host, and json parameters. Baseline 3 is appropriate given full schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description identifies the resource ('common IANA timezone names') and a use context ('for clock calls'), but it lacks an explicit verb such as 'returns', 'lists', or 'provides'. It is not a tautology, but the actual action of the tool remains vague.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'for clock calls' implies this tool is relevant when an agent needs timezone names for clock-related operations. However, it gives no explicit guidance about when to choose this tool over siblings like timezone or utc-time, and no exclusions or alternatives are named.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
inspect-robotsCInspect
Fetch a public robots.txt and return group counts only.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | HTTPS URL to normalize or cite | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| zone | No | IANA timezone name |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden, but it only says the tool fetches a remote public file and returns counts. It does not disclose error behavior for missing robots.txt files, how the fetch is performed, what 'group counts' entails, or whether any response/return structure will be provided.
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 wasted words. It communicates the primary action efficiently, though it sacrifices necessary supporting detail.
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 zero required parameters, no output schema, no annotations, and four oddly mixed parameters, the description is far too thin for an agent to call the tool correctly. It fails to clarify which parameter supplies the target URL or host, what the return format is, or how failures are reported.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema description coverage is 100%, the parameter descriptions are generic and unrelated to robots.txt ('HTTPS URL to normalize or cite', 'JSON text to validate', 'IANA timezone name'), making it unclear which params actually drive the fetch. The description adds no mapping between its operation and the four parameters, and no required params reduce the ambiguity.
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 ('Fetch a public robots.txt') and a precise output scope ('return group counts only'), so an agent can tell what the tool does. It does not explicitly differentiate from sibling tools, but the robots.txt resource is unique enough to avoid obvious confusion with normalize-url or validate-json.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use guidance, prerequisites, or exclusions are provided. An agent can only infer this is for robots.txt inspection; there is no mention of when to prefer this over a sibling or what conditions are required to use it successfully.
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 |
|---|---|---|---|
| url | No | HTTPS URL to normalize or cite | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| zone | No | IANA timezone name |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden of behavioral disclosure. It does disclose one important transformation ('Query and fragment are dropped') beyond the bare verb. It does not, however, describe error behavior, return shape, or what happens with the extra schema parameters (host, json, zone).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with no filler, and the core return behavior is front-loaded. Every phrase 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?
The tool has four parameters and no output schema or annotations, yet the description only addresses the URL behavior; it leaves the relevance of host, json, and zone unexplained. An agent cannot determine what output format to expect or whether calling this tool with anything beyond url is valid.
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 schema already documents each parameter. The description adds no parameter-specific meaning and does not clarify whether host, json, and zone are actually used by normalize-url or ignored.
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: 'Return origin, host, and path for a URL.' It also adds a concrete scoping detail ('Query and fragment are dropped') that makes the behavior precise. It does not explicitly contrast with siblings like url-host, 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?
The description implies the tool is for normalizing/citing HTTPS URLs and dropping query/fragment, which gives a clear use case. However, it never states when to prefer normalize-url over sibling tools such as url-host or citation, and it gives no exclusion conditions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
status-catalogCInspect
Short catalog of common HTTP status codes.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | HTTPS URL to normalize or cite | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| zone | No | IANA timezone name |
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. 'Short catalog' suggests a read-only lookup, but side effects, output format, and availability are never stated. The agent cannot know what calling this tool returns or whether it is safe.
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-loaded, with no filler. But the brevity comes at the cost of substance—one terse noun-phrase sentence does not give the agent enough information to invoke the tool correctly.
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 four optional parameters, no output schema, and no annotations, yet the description explains none of their roles or the tool's return value. For a tool with this complexity and minimal scaffolding, the description 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?
Schema description coverage is 100%, so individual parameters are documented. However, the description does not explain how url, host, json, and zone relate to an HTTP status code catalog, leaving the tool's input expectations unclear.
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 ('catalog of common HTTP status codes') but lacks a verb—it says what the tool is, not what it does. It is distinguishable from the sibling tools by topic, though the operation remains implicit.
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 the sibling tools (citation, compatibility, normalize, validate). The context implies a lookup/reference use case, but no explicit conditions or exclusions are stated.
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 |
|---|---|---|---|
| url | No | HTTPS URL to normalize or cite | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| zone | No | IANA timezone name |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description carries the full behavioral disclosure burden. It only states the result and does not disclose what happens for invalid zone names, whether url/host/json are ignored, the output format, or whether the time is fetched live from a system clock.
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, front-loaded sentence with no filler. It states the essential idea in six words and 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 simple read-only time lookup, the description is close to minimally viable, but the absence of an output schema, no mention of error behavior for invalid zones, and the presence of four apparently unrelated optional parameters leave moderate ambiguity. It is adequate but not complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already documents each parameter, yielding a baseline of 3. The description reinforces that zone is the meaningful parameter, but it does not add details about formatting or the irrelevance of url/host/json beyond implication.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the operation ('current time') and the target resource ('named IANA timezone'), and it is distinct enough from the sibling utc-time by implying timezone-specific lookup. However, it does not explicitly name or contrast with utc-time or iana-zones, so it falls short of full sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The wording implies the appropriate use case — retrieving the current time for a specific IANA timezone — but it never explicitly states when to prefer this over utc-time or how to handle the unrelated optional schema parameters. No exclusions or alternative-routing guidance is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
url-hostDInspect
URL host only
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | HTTPS URL to normalize or cite | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| zone | No | IANA timezone name |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description must disclose behavior on its own, but it contains none: no return value, side effect, error, or state change is mentioned. The schema's note that JSON is 'discarded after the check' is structured field documentation, not behavioral transparency from the tool description. An agent cannot predict what calling this tool will do.
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 three-word description is under-specified rather than appropriately concise for a four-parameter tool with no output schema. It has no front-loaded verb or resource and no structural cues that help an agent parse the tool's 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?
With no annotations and no output schema, the description is the only place to explain return values and behavior, and it is absent. The tool has four optional parameters and ten siblings, so a minimal viable description would at least state what the tool returns and how the parameters are used. This definition is completely inadequate for reliable invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so each parameter is individually documented and the high-coverage baseline applies. However, the tool description adds nothing about how url, host, json, and zone relate, whether they are alternatives or required together, or which one controls the operation.
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 'URL host only' restates the tool name and lacks a verb, so it does not say whether the tool extracts, returns, validates, or normalizes a URL host. It also fails to distinguish this tool from siblings like normalize-url or domain-shape, and the presence of unrelated parameters (json, zone) makes the purpose even less 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?
No usage guidance is provided: the description does not state when to use url-host rather than any of the ten sibling tools. There are no use cases, exclusions, or alternative selection rules, and the schema gives no hints about how the parameters map to a specific workflow.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
utc-timeCInspect
Current UTC timestamp.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | HTTPS URL to normalize or cite | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| zone | No | IANA timezone name |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden, but it only states the output concept. It does not disclose the timestamp format, whether input parameters are ignored, or that the operation is read-only and side-effect free.
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 efficient sentence with no wasted words. It is short but leaves out important behavioral details; that is under-specification rather than a conciseness problem.
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 is a minimal, no-output-schema tool with no annotations and four unexplained optional parameters, so more context is needed. The description tells an agent what value to expect but not the return format or whether any parameters are meaningful.
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 and the schema documents every parameter. However, the parameters (url, host, json, zone) appear unrelated to a UTC timestamp, and the description does not clarify how or whether they affect the call.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool's function: returning the current UTC timestamp. It adds 'current' and 'UTC' specificity beyond the name, though it lacks a verb and does not explicitly distinguish from the sibling 'timezone' tool.
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 usage context is provided: the description does not say when to call this tool, what it is useful for, or how it differs from sibling tools like timezone. There is no guidance on how to handle the four optional input parameters.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
validate-jsonAInspect
Check whether a body is valid JSON. The body is discarded.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | HTTPS URL to normalize or cite | |
| host | No | Public hostname | |
| json | No | JSON text to validate; discarded after the check | |
| zone | No | IANA timezone name |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations available, the description carries the full burden for behavioral disclosure. It does disclose one meaningful behavior: the body is discarded after the check. However, it does not explain what the tool returns for valid versus invalid JSON, whether it accepts any JSON type, or how errors are reported, leaving important behavioral details unspecified.
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 that front-load the core purpose and immediately follow with a key behavioral caveat. There is no wasted wording or irrelevant detail.
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 no output schema and no annotations, so the description must provide enough context for correct invocation. It does not state the return format, what counts as valid JSON, or which parameter should be populated, and the presence of four optional, seemingly unrelated parameters increases the need for clearer guidance. The description is too sparse to be considered complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all four parameters. The description adds little beyond the schema: 'The body is discarded' echoes the json parameter's existing 'discarded after the check' note. It also fails to clarify why url, host, and zone parameters appear in a validate-json tool, which could confuse an agent about which fields are actually relevant.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action ('Check whether a body is valid JSON') and a clear resource ('a body'). It is distinct from all sibling tools, which deal with URLs, timezones, and similar concerns, so an agent can immediately tell what this tool does and that it is not redundant with its siblings.
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 offers clear context: use this tool when you need to validate JSON and do not need the body afterward, since it is discarded. It does not explicitly name alternatives or exclusion conditions, but the sibling set contains no other JSON-validation tool, so the lack of an explicit 'use this instead' is not a serious gap.
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.
11 tool updates
- First observed
citation - First observed
compatibility - First observed
domain-shape - First observed
iana-zones - First observed
inspect-robots - First observed
normalize-url - First observed
status-catalog - First observed
timezone - First observed
url-host - First observed
utc-time - First observed
validate-json
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
Return origin, host, and path. Query and fragment are dropped.
101
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceProvides URL parsing and analysis tools, including component parsing, deterministic hash generation, heuristic safety checks, and metadata extraction, all without external HTTP requests.13MIT
- AlicenseNot gradedqualityCmaintenanceEnables URL parsing and building from components, plus query string parsing, all without keys or online dependencies.17MIT
- AlicenseBqualityAmaintenanceMCP server for opn.onl, the open-source self-hostable URL shortener. Shorten links, read click analytics, generate branded QR codes, and manage links — against the hosted service or your own instance.24482MIT
- FlicenseNot gradedqualityCmaintenanceEnables autonomous agents to precisely deconstruct, analyze, and manipulate URLs and query parameters without hallucination.153-
Glama MCP Gateway
Add one secure layer between your agents and this server.
TDQS
Several tools overlap heavily: citation, normalize-url, and url-host all return host information for URLs, differing only in extra fields. timezone and utc-time both provide current time, and iana-zones is closely related. compatibility is vague and could be confused with citation or status-catalog.
Names mix conventions inconsistently: some use verb_noun (normalize-url, validate-json, inspect-robots), while others are noun-like (citation, compatibility, timezone) or noun-noun (url-host, status-catalog, iana-zones). The pattern is not predictable, making it harder to anticipate related tools.
Eleven tools is within a reasonable range for a utility server, but the scope is scattered across URL handling, timezones, JSON validation, and HTTP status codes. The count is not extreme, yet the tools feel less like a cohesive set and more like an arbitrary collection.
The stated domain is unclear—URL host utilities are mixed with unrelated time and validation helpers, so complete coverage is impossible to assess. For URL tools, there are multiple overlapping operations but no clear lifecycle; for time, there is no conversion or formatting beyond current time. Significant gaps exist for any single coherent purpose.