Skip to main content
Glama

Generate validation report

generate_validation_report
Read-onlyIdempotent

Use this when HTML markup is already supplied. Combines Nu HTML validation with local CSS, SEO, accessibility-signal, and JSON-LD syntax checks. It does not fetch a webpage from base_url; use audit_public_webpage for a live URL.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "html": "<html>"
    },
    "name": "generate_validation_report"
  }
}

Input Schema

NameRequiredDescriptionDefault
cssNoOptional raw CSS source. Linked stylesheets are not fetched.
htmlYesRaw HTML markup supplied by the user; this is not a webpage URL.
base_urlNoOnly resolves relative links when check_links is true; it does not fetch this webpage.
max_linksNoMaximum links to check, from 1 to 20.
check_linksNoWhether to contact eligible public links found in the supplied HTML.

Output Schema

NameRequiredDescriptionDefault
errorNo
linksYes
overviewYes
html_infoYes
redirectsYes
css_errorsYes
seo_issuesYes
css_checkedYes
html_errorsYes
broken_linksYes
css_messagesYes
seo_findingsYes
failed_checksYes
healthy_linksYes
html_messagesYes
html_warningsYes
links_checkedYes
schema_issuesYes
seo_truncatedYes
eligible_linksYes
html_truncatedYes
links_requestedYes
links_truncatedYes
schema_findingsYes
schema_truncatedYes
unverified_linksYes
unreachable_linksYes
html_total_messagesYes
schema_blocks_checkedYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedOutput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • addedOutput schema / properties / eligible_links
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / links_truncated
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / schema_findings / items / properties / code
      Added value: +{
      +  "description": "Stable machine-readable audit rule identifier.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / schema_findings / items / required
      Previous value: -[
      -  "severity",
      -  "category",
      -  "message"
      -]New value: +[
      +  "code",
      +  "severity",
      +  "category",
      +  "message"
      +]
    • addedOutput schema / properties / seo_findings / items / properties / code
      Added value: +{
      +  "description": "Stable machine-readable audit rule identifier.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / seo_findings / items / required
      Previous value: -[
      -  "severity",
      -  "category",
      -  "message"
      -]New value: +[
      +  "code",
      +  "severity",
      +  "category",
      +  "message"
      +]
    • addedOutput schema / properties / unverified_links
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "html_errors",
      -  "css_errors",
      -  "seo_issues",
      -  "schema_issues",
      -  "links_checked",
      -  "broken_links",
      -  "html_warnings",
      -  "html_info",
      -  "html_messages",
      -  "css_messages",
      -  "seo_findings",
      -  "schema_findings",
      -  "links",
      -  "seo_truncated",
      -  "schema_truncated",
      -  "html_total_messages",
      -  "html_truncated",
      -  "schema_blocks_checked",
      -  "healthy_links",
      -  "redirects",
      -  "unreachable_links",
      -  "links_requested",
      -  "css_checked",
      -  "failed_checks",
      -  "overview"
      -]New value: +[
      +  "html_errors",
      +  "css_errors",
      +  "seo_issues",
      +  "schema_issues",
      +  "links_checked",
      +  "eligible_links",
      +  "links_truncated",
      +  "broken_links",
      +  "unverified_links",
      +  "html_warnings",
      +  "html_info",
      +  "html_messages",
      +  "css_messages",
      +  "seo_findings",
      +  "schema_findings",
      +  "links",
      +  "seo_truncated",
      +  "schema_truncated",
      +  "html_total_messages",
      +  "html_truncated",
      +  "schema_blocks_checked",
      +  "healthy_links",
      +  "redirects",
      +  "unreachable_links",
      +  "links_requested",
      +  "css_checked",
      +  "failed_checks",
      +  "overview"
      +]
  2. Changed1 schema field changed
    • changedOutput schema / properties / overview / properties / kind / enum
      Previous value: -[
      -  "html",
      -  "css",
      -  "seo",
      -  "schema",
      -  "links",
      -  "report"
      -]New value: +[
      +  "html",
      +  "css",
      +  "seo",
      +  "schema",
      +  "links",
      +  "report",
      +  "site"
      +]
  3. Changed33 schema fields changed
    • addedInput schema / properties / base_url / description
      Added value: +"Only resolves relative links when check_links is true; it does not fetch this webpage."
    • addedInput schema / properties / check_links / description
      Added value: +"Whether to contact eligible public links found in the supplied HTML."
    • addedInput schema / properties / css / description
      Added value: +"Optional raw CSS source. Linked stylesheets are not fetched."
    • addedInput schema / properties / html / description
      Added value: +"Raw HTML markup supplied by the user; this is not a webpage URL."
    • addedInput schema / properties / max_links / description
      Added value: +"Maximum links to check, from 1 to 20."
    • changedInput schema / properties / max_links / maximum
      Previous value: -25New value: +20
    • addedOutput schema / properties / broken_links / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / broken_links / minimum
      Added value: +0
    • changedOutput schema / properties / broken_links / type
      Previous value: -"number"New value: +"integer"
    • addedOutput schema / properties / css_checked
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / css_errors / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / css_errors / minimum
      Added value: +0
    • changedOutput schema / properties / css_errors / type
      Previous value: -"number"New value: +"integer"
    • changedOutput schema / properties / failed_checks / items / enum
      Previous value: -[
      -  "html",
      -  "css",
      -  "links"
      -]New value: +[
      +  "fetch",
      +  "html",
      +  "css",
      +  "links"
      +]
    • addedOutput schema / properties / html_errors / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / html_errors / minimum
      Added value: +0
    • changedOutput schema / properties / html_errors / type
      Previous value: -"number"New value: +"integer"
    • addedOutput schema / properties / html_info / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / html_info / minimum
      Added value: +0
    • changedOutput schema / properties / html_info / type
      Previous value: -"number"New value: +"integer"
    • addedOutput schema / properties / html_warnings / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / html_warnings / minimum
      Added value: +0
    • changedOutput schema / properties / html_warnings / type
      Previous value: -"number"New value: +"integer"
    • addedOutput schema / properties / links_checked / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / links_checked / minimum
      Added value: +0
    • changedOutput schema / properties / links_checked / type
      Previous value: -"number"New value: +"integer"
    • addedOutput schema / properties / schema_issues / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / schema_issues / minimum
      Added value: +0
    • changedOutput schema / properties / schema_issues / type
      Previous value: -"number"New value: +"integer"
    • addedOutput schema / properties / seo_issues / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / seo_issues / minimum
      Added value: +0
    • changedOutput schema / properties / seo_issues / type
      Previous value: -"number"New value: +"integer"
    • changedOutput schema / required
      Previous value: -[
      -  "html_errors",
      -  "css_errors",
      -  "seo_issues",
      -  "schema_issues",
      -  "links_checked",
      -  "broken_links",
      -  "html_warnings",
      -  "html_info",
      -  "html_messages",
      -  "css_messages",
      -  "seo_findings",
      -  "schema_findings",
      -  "links",
      -  "seo_truncated",
      -  "schema_truncated",
      -  "html_total_messages",
      -  "html_truncated",
      -  "schema_blocks_checked",
      -  "healthy_links",
      -  "redirects",
      -  "unreachable_links",
      -  "links_requested",
      -  "failed_checks",
      -  "overview"
      -]New value: +[
      +  "html_errors",
      +  "css_errors",
      +  "seo_issues",
      +  "schema_issues",
      +  "links_checked",
      +  "broken_links",
      +  "html_warnings",
      +  "html_info",
      +  "html_messages",
      +  "css_messages",
      +  "seo_findings",
      +  "schema_findings",
      +  "links",
      +  "seo_truncated",
      +  "schema_truncated",
      +  "html_total_messages",
      +  "html_truncated",
      +  "schema_blocks_checked",
      +  "healthy_links",
      +  "redirects",
      +  "unreachable_links",
      +  "links_requested",
      +  "css_checked",
      +  "failed_checks",
      +  "overview"
      +]
  4. Changed10 schema fields changed
    • addedOutput schema / properties / failed_checks
      Added value: +{
      +  "items": {
      +    "enum": [
      +      "html",
      +      "css",
      +      "links"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / healthy_links
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / html_total_messages
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / html_truncated
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / links_requested
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / overview
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "counts": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "key": {
      +            "type": "string"
      +          },
      +          "label": {
      +            "type": "string"
      +          },
      +          "tone": {
      +            "enum": [
      +              "error",
      +              "warning",
      +              "info",
      +              "success"
      +            ],
      +            "type": "string"
      +          },
      +          "value": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "key",
      +          "label",
      +          "value",
      +          "tone"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "detail": {
      +      "type": "string"
      +    },
      +    "headline": {
      +      "type": "string"
      +    },
      +    "kind": {
      +      "enum": [
      +        "html",
      +        "css",
      +        "seo",
      +        "schema",
      +        "links",
      +        "report"
      +      ],
      +      "type": "string"
      +    },
      +    "next_action": {
      +      "type": "string"
      +    },
      +    "shown": {
      +      "maximum": 9007199254740991,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "status": {
      +      "enum": [
      +        "passed",
      +        "needs_attention",
      +        "partial",
      +        "failed",
      +        "not_applicable"
      +      ],
      +      "type": "string"
      +    },
      +    "title": {
      +      "type": "string"
      +    },
      +    "total": {
      +      "maximum": 9007199254740991,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "truncated": {
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "status",
      +    "title",
      +    "headline",
      +    "detail",
      +    "total",
      +    "shown",
      +    "truncated",
      +    "counts"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / redirects
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / schema_blocks_checked
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / unreachable_links
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "html_errors",
      -  "css_errors",
      -  "seo_issues",
      -  "schema_issues",
      -  "links_checked",
      -  "broken_links",
      -  "html_warnings",
      -  "html_info",
      -  "html_messages",
      -  "css_messages",
      -  "seo_findings",
      -  "schema_findings",
      -  "links",
      -  "seo_truncated",
      -  "schema_truncated"
      -]New value: +[
      +  "html_errors",
      +  "css_errors",
      +  "seo_issues",
      +  "schema_issues",
      +  "links_checked",
      +  "broken_links",
      +  "html_warnings",
      +  "html_info",
      +  "html_messages",
      +  "css_messages",
      +  "seo_findings",
      +  "schema_findings",
      +  "links",
      +  "seo_truncated",
      +  "schema_truncated",
      +  "html_total_messages",
      +  "html_truncated",
      +  "schema_blocks_checked",
      +  "healthy_links",
      +  "redirects",
      +  "unreachable_links",
      +  "links_requested",
      +  "failed_checks",
      +  "overview"
      +]
  5. Changed10 schema fields changed
    • addedOutput schema / properties / css_messages
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "context": {
      +        "type": "string"
      +      },
      +      "line": {
      +        "type": "number"
      +      },
      +      "message": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "line",
      +      "message"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / html_info
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / html_messages
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "column": {
      +        "type": "number"
      +      },
      +      "line": {
      +        "type": "number"
      +      },
      +      "message": {
      +        "type": "string"
      +      },
      +      "type": {
      +        "enum": [
      +          "error",
      +          "warning",
      +          "info"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "message"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / html_warnings
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / links
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "message": {
      +        "type": "string"
      +      },
      +      "ok": {
      +        "type": "boolean"
      +      },
      +      "status": {
      +        "anyOf": [
      +          {
      +            "type": "number"
      +          },
      +          {
      +            "enum": [
      +              "blocked",
      +              "failed"
      +            ],
      +            "type": "string"
      +          }
      +        ]
      +      },
      +      "url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "url",
      +      "status",
      +      "ok"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / schema_findings
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "category": {
      +        "enum": [
      +          "SEO",
      +          "Schema",
      +          "Accessibility"
      +        ],
      +        "type": "string"
      +      },
      +      "message": {
      +        "type": "string"
      +      },
      +      "severity": {
      +        "enum": [
      +          "error",
      +          "warning",
      +          "info"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "severity",
      +      "category",
      +      "message"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / schema_truncated
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / seo_findings
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "category": {
      +        "enum": [
      +          "SEO",
      +          "Schema",
      +          "Accessibility"
      +        ],
      +        "type": "string"
      +      },
      +      "message": {
      +        "type": "string"
      +      },
      +      "severity": {
      +        "enum": [
      +          "error",
      +          "warning",
      +          "info"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "severity",
      +      "category",
      +      "message"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / seo_truncated
      Added value: +{
      +  "type": "boolean"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "html_errors",
      -  "css_errors",
      -  "seo_issues",
      -  "schema_issues",
      -  "links_checked",
      -  "broken_links"
      -]New value: +[
      +  "html_errors",
      +  "css_errors",
      +  "seo_issues",
      +  "schema_issues",
      +  "links_checked",
      +  "broken_links",
      +  "html_warnings",
      +  "html_info",
      +  "html_messages",
      +  "css_messages",
      +  "seo_findings",
      +  "schema_findings",
      +  "links",
      +  "seo_truncated",
      +  "schema_truncated"
      +]
  6. First observed

TDQS

A4.5/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true, openWorldHint=true, idempotentHint=true, and destructiveHint=false. The description adds useful behavioral context by clarifying that it validates supplied markup locally and does not fetch the base_url webpage, though it does not discuss the network behavior of optional link checking (covered 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.

Conciseness5/5

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

The description is compact and front-loaded: the first sentence establishes the use case, the second states the combined checks, and the third prevents a key misuse. Every sentence earns its place.

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

Completeness5/5

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

Given the moderate parameter count, 100% schema coverage, annotations, and an output schema, the description is complete enough. It covers the core use case, scope of checks, non-fetching behavior, and the main alternative tool without needing to restate return values.

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

Parameters3/5

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

Schema description coverage is 100%, so the input schema already documents all five parameters. The description reinforces that HTML is supplied markup rather than a URL and that base_url is not fetched, but it does not add parameter details beyond what the schema provides.

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

Purpose5/5

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

The description states a specific operation: combining Nu HTML validation with local CSS, SEO, accessibility-signal, and JSON-LD syntax checks on supplied HTML markup. It also distinguishes the tool from audit_public_webpage by stating that this tool does not fetch a live webpage.

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

Usage Guidelines5/5

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

The description explicitly gives the when-to-use condition ('when HTML markup is already supplied'), the when-not-to-use condition ('does not fetch a webpage from base_url'), and the alternative ('use audit_public_webpage for a live URL'). This leaves little ambiguity about tool selection.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources