HTTP 504 gateway-timeout
Server Details
Meaning of HTTP 504.
- Status
- Unhealthy
- Last Tested
- Transport
- Streamable HTTP
- URL
- Repository
- sadri-dridi/named-mcp-utilities
- GitHub Stars
- 0
TDQS
Most tools have distinct purposes (e.g., fetch robots, validate JSON, normalize URL), but there is some overlap between HTTP-status-related tools: `http-504` and `status-catalog` both deal with HTTP status codes, which could cause confusion. Time-related tools (`utc-time` and `timezone`) are clearly differentiated by description.
Naming conventions are inconsistent: some tools use hyphenated verb-noun patterns (`inspect-robots`, `normalize-url`, `validate-json`), while others are single nouns (`citation`, `compatibility`) or noun-like hyphenations (`domain-shape`, `status-catalog`). This mixed style makes the API feel less predictable.
With 11 tools, the set is within the typical 3–15 range and feels appropriately scoped for a utility library. Each tool serves a distinct function, and there is no excessive redundancy or bloat.
The tools cover a useful set of web-development utilities (URL, HTTP status, time, validation, robots), but the collection is somewhat eclectic and lacks a cohesive domain. There are no glaring gaps for the intended purpose, yet the completeness is moderate given its mixed nature.
Available Tools
11 toolscitationAInspect
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?
The note 'Page content is not stored' discloses a behavioral guarantee. Since no annotations are provided, this statement adds transparency about side effects, though it does not mention other potential behaviors like network requests.
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 the primary purpose front-loaded in the first sentence and additional behavior in a second short sentence. No unnecessary detail is present.
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 explains only the URL-related functionality, leaving the roles of 'host', 'json', and 'zone' parameters unaddressed in the tool's overall context. The schema descriptions individually explain them, but the tool's description does not tie them together, causing ambiguity about the full scope.
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 four parameters (url, host, json, zone) with meaningful text, so schema coverage is 100%. The tool description adds no extra meaning beyond the schema, maintaining the baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool returns host, scheme, and HTTP status for a URL, using a specific verb and resource. It distinguishes from sibling tools like normalize-url and status-catalog by its explicit output.
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 is provided about when to use this tool versus alternatives such as normalize-url or status-catalog. The description does not mention any conditions or exclusions.
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 carries the full burden. It only notes 'No identifiers are retained,' which is a privacy guarantee, but it fails to disclose whether the operation is read-only, what happens to the inputs, whether any side effects occur, or what the output format looks like. This is a significant gap for a tool that accepts arbitrary URLs and JSON.
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 fluff, so it is compact. However, the content is under-specified – the first sentence is vague and the second is a privacy note. It is not front-loaded with useful information because the core purpose is unclear. It earns a middle score: concise in form but not in substance.
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 four optional parameters, no output schema, and no annotations, the description is severely incomplete. It fails to explain what 'classification' means, what the tool does with the inputs, what the response looks like, or when to use it. This is wholly inadequate for an agent 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 all four parameters (url, host, json, zone) are documented in the schema. However, the description adds no meaning about how these parameters relate to 'classification' – it doesn't explain their roles or how they interact. Since the schema already documents the parameters, the baseline 3 applies, but the description offers no added value beyond 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 says 'Show how this request is classified' – a vague verb and resource. It doesn't specify what 'classified' means (e.g., compatibility with a standard, request type, or something else), nor does it differentiate from siblings like normalize-url or validate-json. It's not a tautology but is too ambiguous to inform selection.
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. It doesn't mention any context, exclusions, or prerequisites. An agent has no way to decide between this and the many sibling tools with overlapping input parameters.
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?
With no annotations provided, the description must carry the behavioral disclosure burden. It does disclose that the tool does not include WHOIS or ownership data, which is a useful limitation. However, it does not describe side effects, what happens with non-hostname inputs (e.g., json or zone), or the return format, leaving gaps in behavioral transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that front-loads the core action ('Split a hostname into labels') and adds a key limitation. There is no wasted wording, and it is appropriately sized for a simple tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has 4 diverse parameters (url, host, json, zone) and no output schema, the description is too narrow. It only explains the hostname-splitting function, leaving the purpose and handling of the other parameters unexplained. Without annotations or output schema, this incompleteness makes it hard for an agent to correctly invoke the tool for non-hostname inputs.
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 description coverage is 100%, so each parameter already has a clear description. The tool description adds minimal parameter context—only implying that 'hostname' is relevant. Since the schema covers the parameters thoroughly, the baseline of 3 is appropriate; the description does not significantly enhance parameter understanding.
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 clear verb ('split') and resource ('hostname into labels'), and explicitly states the exclusion of WHOIS/ownership data, which helps distinguish it from potential ownership-related tools. However, it does not mention that the tool accepts multiple input types (url, host, json, zone) from the schema, so it is not fully precise about its scope.
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 sibling tools like normalize-url or validate-json. It does not state prerequisites, alternatives, or conditions for selecting this tool over others, leaving the agent to infer usage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
http-504CInspect
Meaning of HTTP 504.
| 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. It only states 'Meaning of HTTP 504' and gives no information about side effects, return format, or whether it's read-only. The presence of unrelated parameters (url, host, json, zone) is unexplained, creating a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely short, but this is under-specification rather than conciseness. It provides no actionable information beyond the tool's name, failing to earn its place as a useful definition.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of an output schema, no annotations, and four irrelevant parameters, the description is woefully incomplete. An agent has no way to determine how to invoke the tool correctly or what the expected behavior is.
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 description adds no value by connecting the parameters to the tool's purpose. The parameters (url, host, json, zone) are entirely unrelated to HTTP 504, and the description does not clarify why they exist or how they are used, making them misleading.
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 the purpose as 'Meaning of HTTP 504,' which is clear and specific about what the tool explains. However, it does not differentiate from sibling 'status-catalog,' which likely also covers status codes, and it doesn't mention how the input parameters relate to this 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?
No guidance is given on when to use this tool versus alternatives like status-catalog. The description provides no context about selection criteria or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
iana-zonesDInspect
Common IANA timezone names for clock calls.
| Name | Required | Description | Default |
|---|---|---|---|
| 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 carries the full burden of disclosing behavior. It only says 'common IANA timezone names' with no mention of side effects, return format, permissions, or what happens with the provided parameters. The behavior is essentially undisclosed.
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 (one sentence) but under-specifies the tool's functionality. Brevity without substantive content is not effective conciseness; it omits essential information an agent needs to use 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?
With 4 parameters, no output schema, and no annotations, the description fails to explain what the tool returns, how inputs are used, or how it differs from related siblings. It is grossly inadequate for an agent to invoke 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?
Although the schema covers 100% of parameters with individual descriptions, the tool description does not explain how url, host, json, and zone relate to timezone names. The description adds zero semantic context beyond the schema, and the parameters appear disconnected from the stated purpose, creating confusion.
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 resource ('Common IANA timezone names') but no clear action or verb. 'for clock calls' is vague and doesn't specify whether the tool lists, validates, or converts timezones. It does not differentiate from siblings like timezone or utc-time.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus the sibling tools. The description gives no context, prerequisites, or exclusions, leaving the agent without any basis for selection.
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 |
|---|---|---|---|
| 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 of behavioral disclosure. It states it fetches a 'public' robots.txt, implying accessibility, but does not disclose error handling (e.g., 404s, redirects), rate limits, or what 'group counts' means. It gives minimal insight beyond the basic action.
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 zero filler. It conveys the essential action and output efficiently. There is no wasted text or unnecessary 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?
For a tool with 4 parameters, no output schema, and no annotations, the description is insufficient. It does not explain the meaning of 'group counts', which parameter selects the target, how failures are handled, or what the returned data looks like. An agent would need to infer or experiment 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?
Although the schema covers 100% of parameters with descriptions, the tool description does not link any parameter to the robots.txt fetch. The schema descriptions are generic (e.g., 'HTTPS URL to normalize or cite' for url, 'JSON text to validate' for json) and appear unrelated to the tool's purpose, causing confusion. The description adds no clarification on which parameter should be used to provide the target URL.
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 verb (fetch), the resource (public robots.txt), and the output (group counts only). It is unambiguous and distinct from sibling tools, none of which mention robots.txt or scraping. An agent can immediately understand the tool's core function.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus alternatives, no prerequisites, and no mention of which parameter specifies the target URL. The description merely states what it does without contextualizing its use case or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
normalize-urlCInspect
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 must disclose all behavioral traits. It correctly states that query and fragment are dropped, but it completely ignores the other three parameters (host, json, zone) that appear in the schema. This creates a gap where an agent cannot understand how those parameters affect behavior or why they exist. The description is not misleading, but it is incomplete for a tool with four parameters.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, tightly worded sentence that conveys the essential behavior. It is front-loaded with the primary action and outcome, with no filler or redundant information. It earns a top score for efficiency.
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 but the description only addresses one. There is no explanation of how the parameters interact, what the expected input format is beyond 'HTTPS URL', or what happens if a URL is invalid. With no output schema, the description should provide more context about return values and edge cases, but it is minimal. This leaves an agent under-informed for a multi-parameter 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 coverage is 100%, so each parameter has a description. The tool description adds value for the 'url' parameter by explaining the output format, but it does nothing for 'host', 'json', or 'zone'. Since the baseline for 100% coverage is 3, and the description adds only marginal context for one parameter, this score is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific operation: return origin, host, and path from a URL, and explicitly notes that query and fragment are dropped. This clearly identifies the tool's purpose and distinguishes it from siblings like domain-shape or inspect-robots, though it doesn't name alternatives. The presence of unrelated parameters in the schema slightly muddies the clarity, but the core purpose 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 guidance on when to use this tool versus alternatives. It does not mention any conditions, prerequisites, or exclusions. An agent would have to infer that this is for extracting URL components, but nothing explicitly states when to choose normalize-url over other tools like domain-shape or status-catalog.
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 |
|---|---|---|---|
| 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 burden of behavioral disclosure. It does not mention what the tool does with the parameters, what it returns, whether it performs network requests, or any side effects. The description is silent on all behavioral aspects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short, but this is under-specification rather than conciseness. It lacks essential information about what the tool does, how to invoke it, or what output to expect. A concise description should be informative, not merely brief.
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 4 parameters, no required fields, no output schema, and a vague one-line description, the tool is not usable by an agent. There is no explanation of the tool's function, parameter usage, or return value. This is completely inadequate for a tool with this complexity and sibling context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has 100% coverage with each parameter described, but the tool description adds no meaning linking these parameters (url, host, json, zone) to a 'status catalog'. The schema descriptions themselves seem inconsistent with the tool's purpose—e.g., 'url' is described as 'HTTPS URL to normalize or cite', which suggests a different functionality. The description fails to clarify how these parameters are used.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description is a noun phrase 'Short catalog of common HTTP status codes' without a verb indicating what action the tool performs. It does not distinguish itself from siblings like http-504 or normalize-url, and the name 'status-catalog' is only slightly expanded. The purpose remains ambiguous—does it list codes, check a URL's status, or validate something?
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. There are no conditions, exclusions, or references to sibling tools. With siblings like http-504 and validate-json, an agent has no way to know which tool to select.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
timezoneCInspect
Current time in a named IANA timezone.
| 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 must carry the full burden of behavioral disclosure. It only says 'current time' without indicating return format, error handling for invalid zones, whether it makes network calls, or if it's read-only. For a simple tool this is a minimal but insufficient disclosure.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence, front-loaded with the core purpose. It is concise and to the point, though it might benefit from a few more words to cover essential behavior. No fluff or redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple but lacks an output schema. The description does not explain the return format, error behavior, or the fact that only 'zone' is used. The unrelated parameters in the schema are a significant gap that could mislead an agent. Given the potential for misuse, more context is needed.
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 each parameter has a description. However, the description does not clarify that only 'zone' is relevant; the schema includes url, host, and json with descriptions unrelated to timezone, creating confusion. The description adds no meaning beyond the schema and fails to resolve the mismatch.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear, specific purpose: getting the current time in a named IANA timezone. It distinguishes from siblings like utc-time (which likely returns UTC) and iana-zones (which lists zones). The verb 'get' is implied, and the resource 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 provided on when to use this tool versus alternatives like utc-time or iana-zones. There is no mention of prerequisites, fallback, or exclusions. An agent has no help in choosing this over similar siblings.
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?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states the result and does not disclose how the input parameters (url, host, json, zone) are handled, whether they are ignored, or what the output format is. It does not even indicate that the tool is read-only or non-destructive, leaving the agent uncertain about side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely short, but it under-specifies essential details rather than being concisely informative. It omits critical information such as parameter handling, output format, and usage context. This is not efficient conciseness but rather a lack of substance.
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 4 parameters and no output schema, the description is incomplete. It fails to clarify the tool's interface, parameter semantics, or return value. An agent would be unable to confidently invoke this tool based on the current description, especially given the mismatched parameters.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds no meaning to the parameters. Although the schema provides descriptions for each parameter (100% coverage), these parameters are unrelated to a UTC timestamp. The description does not explain why they exist or whether they are used, creating confusion about whether they are required or optional. The agent cannot determine how to call the tool correctly without additional guidance.
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 states the tool's purpose: it returns the current UTC time. It is a specific verb (get current) and resource (UTC timestamp). However, it does not differentiate from sibling tools like 'timezone' or 'iana-zones', nor does it clarify that no parameters are needed, which slightly reduces clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. There is no mention of prerequisites, exclusions, or context where this tool is preferred over 'timezone' or 'iana-zones'. The agent is left to infer usage without any directional help.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
validate-jsonCInspect
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 provided, the description carries the full burden. It discloses that the body is discarded, which is useful, but it doesn't explain what 'body' refers to (likely the 'json' parameter), whether the tool returns a result (e.g., true/false), or how the other schema parameters (url, host, zone) relate to validation. This lack of detail is a significant gap for a validation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with no wasted words. It front-loads the primary purpose and adds a key behavioral note about discarding the body. This is concise and well-structured.
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 validation tool, the description is incomplete. It doesn't specify which parameter holds the JSON to validate, what the return value is (there is no output schema), or how the other parameters are used. The schema lists unrelated parameters (url, host, zone) that are not explained, leaving an agent unsure 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?
The schema has 100% coverage with descriptions for all four parameters, so the baseline is 3. The tool description adds no parameter-specific meaning; it only mentions 'body' without mapping it to the 'json' parameter. Since it doesn't contradict the schema and the schema itself is descriptive, the baseline holds, though the description misses an opportunity to clarify which parameter is the body.
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) and the resource (whether a body is valid JSON), which distinguishes it from sibling tools that handle URLs, timezones, or HTTP statuses. However, it doesn't explicitly differentiate itself from any sibling that might also handle JSON, and the presence of unrelated parameters in the schema slightly clouds the 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?
There is no guidance on when to use this tool versus alternatives, no mention of prerequisites, and no exclusions. The description simply states what it does without any context for selection, leaving an agent to guess when it is the appropriate choice among the sibling tools.
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
http-504 - First observed
iana-zones - First observed
inspect-robots - First observed
normalize-url - First observed
status-catalog - First observed
timezone - 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
Meaning of HTTP 503.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceBridges stdio Model Context Protocol (MCP) servers to MCP Streamable HTTP behind a single gateway, enabling multi-tenant, multi-user deployment with per-tenant environment variables via HTTP headers.-
- FlicenseNot gradedqualityCmaintenanceMCP server providing time retrieval and echo tools, running as an independent network process over Streamable HTTP.-
- FlicenseNot gradedqualityBmaintenanceAggregates multiple MCP servers into a single HTTP gateway, enabling clients like Hermes to access Excel, PowerPoint, and other tools through one authenticated endpoint.-
- AlicenseNot gradedqualityBmaintenanceEnables multiple MCP clients to securely access various third-party MCP backends through a single HTTP gateway, with modern MCP handshake compatibility and session lifecycle management.19MIT