{
  "specVersion": "1.0",
  "host": {
    "displayName": "Stephen Sumner",
    "identifier": "stephensumner.com",
    "documentationUrl": "https://stephensumner.com/llms.txt",
    "logoUrl": "https://stephensumner.com/assets/logo-mark-slate.png"
  },
  "entries": [
    {
      "identifier": "urn:air:stephensumner.com:mcp:site",
      "displayName": "stephensumner.com MCP server",
      "type": "application/mcp-server-card+json",
      "url": "https://mcp.stephensumner.com/mcp/server-card",
      "description": "Read-only MCP server exposing every post and page on stephensumner.com: list, read as Markdown, full-text search, and the site overview. Streamable HTTP, no authentication.",
      "tags": [
        "seo",
        "ai-search",
        "content",
        "mcp"
      ],
      "capabilities": [
        "list_content",
        "get_content",
        "search_content",
        "site_overview"
      ],
      "representativeQueries": [
        "what does Stephen Sumner say about llms.txt v2",
        "search stephensumner.com for Early Hints",
        "read Stephen Sumner's post on how his site is built as markdown",
        "list Stephen Sumner's blog posts"
      ]
    },
    {
      "identifier": "urn:air:stephensumner.com:skill:ai-readiness-audit",
      "displayName": "AI readiness audit (120 points)",
      "type": "application/agent-skills+md",
      "url": "https://stephensumner.com/.well-known/agent-skills/ai-readiness-audit/SKILL.md",
      "description": "Score a page or site out of 120 for AI-search readiness across six categories: crawl eligibility, helpful content, extractability, technical structure, schema and AI access, agentic browsing.",
      "tags": [
        "seo",
        "ai-search",
        "geo",
        "audit"
      ],
      "capabilities": [
        "audit",
        "scoring",
        "recommendations"
      ],
      "representativeQueries": [
        "audit my website for AI search readiness",
        "why is my page not cited in Google AI Overviews or ChatGPT",
        "score this URL against the 120-point AI readiness framework"
      ]
    },
    {
      "identifier": "urn:air:stephensumner.com:skill:llms-txt-v2",
      "displayName": "llms.txt v2 implementation",
      "type": "application/agent-skills+md",
      "url": "https://stephensumner.com/.well-known/agent-skills/llms-txt-v2/SKILL.md",
      "description": "Create, review or upgrade a site's llms.txt to the August 2026 v2 proposal: link relations, markdown twins, the six-step checklist and a template.",
      "tags": [
        "llms-txt",
        "ai-search",
        "seo"
      ],
      "capabilities": [
        "create",
        "review",
        "upgrade"
      ],
      "representativeQueries": [
        "add an llms.txt file to my website",
        "what changed in llms.txt v2 and do I need to update mine",
        "review my llms.txt"
      ]
    },
    {
      "identifier": "urn:air:stephensumner.com:skill:static-site-performance",
      "displayName": "Static site that scores 100",
      "type": "application/agent-skills+md",
      "url": "https://stephensumner.com/.well-known/agent-skills/static-site-performance/SKILL.md",
      "description": "Build or rebuild a small content site as hand-written static HTML that scores 100 in every Lighthouse category: fonts, images, Cloudflare Pages headers, SEO plumbing and 2026 CSS platform features.",
      "tags": [
        "web-performance",
        "lighthouse",
        "cloudflare",
        "static-site"
      ],
      "capabilities": [
        "build",
        "optimise",
        "headers"
      ],
      "representativeQueries": [
        "how do I get PageSpeed to 100 on mobile",
        "set up a Cloudflare Pages _headers file with security and caching",
        "make my site fast without a framework"
      ]
    },
    {
      "identifier": "urn:air:stephensumner.com:skill:ecommerce-seo-pillars",
      "displayName": "eCommerce SEO, five pillars",
      "type": "application/agent-skills+md",
      "url": "https://stephensumner.com/.well-known/agent-skills/ecommerce-seo-pillars/SKILL.md",
      "description": "Audit or plan eCommerce SEO across five pillars (technical, authority, relevance, experience, AI search) and choose where to start from the store's symptoms.",
      "tags": [
        "seo",
        "ecommerce",
        "audit"
      ],
      "capabilities": [
        "audit",
        "prioritisation"
      ],
      "representativeQueries": [
        "review my online store's SEO",
        "why is my shop ranking but not selling",
        "where should I start with eCommerce SEO"
      ]
    },
    {
      "identifier": "urn:air:stephensumner.com:content:llms-txt",
      "displayName": "Site overview (llms.txt)",
      "type": "text/markdown",
      "url": "https://stephensumner.com/llms.txt",
      "description": "Who Stephen Sumner is and a curated map of the site for agents: every page with a one-line summary, feeds, MCP server, skills and contact.",
      "tags": [
        "llms-txt",
        "overview"
      ],
      "representativeQueries": [
        "who is Stephen Sumner",
        "give me an overview of stephensumner.com"
      ]
    },
    {
      "identifier": "urn:air:stephensumner.com:api:catalog",
      "displayName": "API catalog (RFC 9727)",
      "type": "application/linkset+json",
      "url": "https://stephensumner.com/.well-known/api-catalog",
      "description": "Linkset of every machine interface the site offers: the MCP server with descriptor and health, the content index, the agent skills index and the feeds.",
      "tags": [
        "api",
        "discovery"
      ],
      "representativeQueries": [
        "what APIs does stephensumner.com offer",
        "where is the health endpoint for Stephen Sumner's MCP server"
      ]
    }
  ]
}