The Website Specification — MCP server

Streamable HTTP MCP endpoint at POST /mcp. Stateless. Reference tools are public; site analysis requires an operator-issued audit token.

Connect (Claude Desktop, MCP-aware clients)

{
  "mcpServers": {
    "specification-website": {
      "transport": "http",
      "url": "https://mcp.specification.website/mcp"
    }
  }
}

Tools

• search(query, limit?) — full-text across every spec page
• list_topics({ category?, status?, limit? }) — filtered index
• get_topic({ slug }) — full Markdown for one page
• get_checklist({ category?, status? }) — flat checklist
• get_categories() — taxonomy with counts
• get_changes({ since?, type?, limit? }) — spec changelog, resolved to current topics
• analyze_site({ url, maxPages?, includeJev? }) — HTTP checks and Jev text judgements, with evidence and unverified topics; requires X-Audit-Token and an approved hostname

Prompts

• audit_url(url, focus?) — generates an audit plan for a target URL

Also speaks A2A

Agent-to-Agent JSON-RPC endpoint at POST /a2a/v1; agent card at /.well-known/agent-card.json. message/send wraps the same search; other A2A methods return method-not-found.

Discovery

• MCP server card: specification.website/.well-known/mcp/server-card.json
• A2A agent card: specification.website/.well-known/agent-card.json
• Spec pages: mcp-and-tool-discovery, a2a-agent-cards
• Source: github.com/jdevalk/specification.website