specification.website

{
  "name": "search_spec",
  "kind": "read",
  "impl": "imperative",
  "description": "Search The Website Specification for matching topics. Returns ranked results with title, status, category, canonical URL, and a one-line summary. Use this when the user asks about a topic by keyword (e.g. \"CSP\", \"alt text\", \"llms.txt\").",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text query.",
        "minLength": 1
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 25,
        "default": 5
      }
    },
    "required": [
      "query"
    ]
  },
  "page": "/"
}

{
  "name": "list_topics",
  "kind": "read",
  "impl": "imperative",
  "description": "List spec topics, optionally filtered by category and/or status. Returns title, status, category, summary, and URL for each. Use this when the user wants the canonical list (e.g. \"all required SEO topics\").",
  "inputSchema": {
    "type": "object",
    "properties": {
      "category": {
        "type": "string",
        "enum": [
          "foundations",
          "seo",
          "accessibility",
          "security",
          "well-known",
          "agent-readiness",
          "performance",
          "privacy",
          "resilience",
          "i18n"
        ],
        "description": "Restrict to one category."
      },
      "status": {
        "type": "string",
        "enum": [
          "required",
          "recommended",
          "optional",
          "avoid"
        ],
        "description": "Restrict to one status."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 200,
        "description": "Cap the number of items returned."
      }
    }
  },
  "page": "/"
}

{
  "name": "get_topic",
  "kind": "read",
  "impl": "imperative",
  "description": "Fetch the full Markdown for one spec page by its slug. Returns the rendered body with YAML frontmatter (title, status, sources). Use this after search_spec or list_topics to read the canonical guidance.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "Kebab-case slug, as listed by list_topics or search_spec. Examples: 'content-security-policy', 'meta-robots', 'llms-txt'.",
        "minLength": 1
      }
    },
    "required": [
      "slug"
    ]
  },
  "page": "/"
}

{
  "name": "open_search",
  "kind": "action",
  "impl": "imperative",
  "description": "Open the on-page ⌘K search overlay so the user can search the spec interactively. Optionally pre-fills a query. UI action — does not return results; use search_spec for that.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Optional initial query to pre-fill."
      }
    }
  },
  "page": "/"
}

{
  "name": "open_checklist",
  "kind": "action",
  "impl": "imperative",
  "description": "Navigate the user to the full spec checklist page. Optionally jumps to a category section via URL hash. UI action — does not return data.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "category": {
        "type": "string",
        "enum": [
          "foundations",
          "seo",
          "accessibility",
          "security",
          "well-known",
          "agent-readiness",
          "performance",
          "privacy",
          "resilience",
          "i18n"
        ],
        "description": "Optional category to scroll to."
      }
    }
  },
  "page": "/"
}