@jrpool/kilotest 41.1.0 → 42.0.2

package/.github/workflows/publish-mcp.yml

@@ -0,0 +1,57 @@
+name: Publish to MCP Registry
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'server.json'
+      - 'api/version.js'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # Required for GitHub OIDC authentication with the MCP Registry
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v7
+
+      - name: Set Node.js version
+        uses: actions/setup-node@v4
+        with:
+          node-version: '>=22.12.0'
+
+      - name: Verify server.json version matches api/version.js
+        run: |
+          FILE_VERSION=$(node -e "console.log(require('./api/version').version)")
+          JSON_VERSION=$(node -e "console.log(require('./server.json').version)")
+          if [ "$FILE_VERSION" != "$JSON_VERSION" ]; then
+            echo "::error::server.json version ($JSON_VERSION) does not match api/version.js version ($FILE_VERSION)"
+            exit 1
+          fi
+          echo "Versions match: $FILE_VERSION"
+
+      - name: Install mcp-publisher
+        run: |
+          set -euo pipefail
+          OS="$(uname -s | tr '[:upper:]' '[:lower:]')"
+          ARCH="$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')"
+          ASSET_NAME="mcp-publisher_${OS}_${ARCH}.tar.gz"
+          RELEASE_JSON="$(curl -fsSL https://api.github.com/repos/modelcontextprotocol/registry/releases/latest)"
+          EXPECTED_SHA256="$(echo "$RELEASE_JSON" | jq -r --arg name "$ASSET_NAME" '.assets[] | select(.name == $name) | .digest' | sed 's/^sha256://')"
+          [ -n "$EXPECTED_SHA256" ]
+          curl -fsSL -o "$ASSET_NAME" "https://github.com/modelcontextprotocol/registry/releases/latest/download/${ASSET_NAME}"
+          echo "${EXPECTED_SHA256}  ${ASSET_NAME}" | sha256sum -c -
+          tar xz -f "$ASSET_NAME" mcp-publisher
+          chmod +x ./mcp-publisher
+
+      - name: Authenticate to MCP Registry
+        run: ./mcp-publisher login github-oidc
+
+      - name: Validate server.json
+        run: ./mcp-publisher validate
+
+      - name: Publish to MCP Registry
+        run: ./mcp-publisher publish

package/api/version.js

@@ -0,0 +1,8 @@
+/*
+  version.js
+  Single source of truth for the version of the Kilotest API and MCP tool contract, consumed by mcp.js and scripts/generate-openapi.js.
+*/
+
+// CONSTANTS
+
+exports.version = '2.1.0';

package/docs/SERVICE.md

@@ -203,7 +203,7 @@ kilotest.com {
   }
   @allowedPOST {
     method POST
-    path /mcp /retestRec.html/* /testRec.html /recAction.html /reannotate.html /wcagRenew.html /api/* /worker/* /tutorialComment.html
+    path /mcp /retestRec.html/* /testRec.html /recAction.html /reannotate.html /wcagRenew.html /api/* /tutorialComment.html
   }
   # Respond to OPTIONS requests.
   @allowedOPTIONS method OPTIONS

package/index.html

@@ -15,6 +15,7 @@
         "name": "Kilotest",
         "sameAs": "https://github.com/jrpool/kilotest",
         "datePublished": "2025-10-14",
+        "dateModified": "2026-08-26",
         "applicationCategory": "Front-end quality (i.e. web accessibility, usability, and standards conformity) testing and reporting service",
         "isAccessibleForFree": true,
         "description": "Testing of web pages for front-end quality (i.e. web accessibility, usability, and standards conformity) with an ensemble of 10 rule engines and provision of results at selectable levels of detail.",
@@ -58,23 +59,30 @@
     <main>
       <h1>Kilotest</h1>
       <p>Kilotest performs more than a thousand tests on a web page.</p>
-      <p>New to accessibility testing? <a href="/tutorial.html">Start with the tutorial.</a></p>
       <details>
         <summary>More than a thousand? Really?</summary>
         <h2>Ensemble testing</h2>
-        <p>Kilotest does <strong>ensemble testing</strong> of web pages for <a href="https://www.w3.org/mission/accessibility/">accessibility</a>, usability, and conformity to HTML standards.</p>
+        <p>Kilotest does <strong>ensemble testing</strong> of web pages for <a href="https://www.w3.org/mission/accessibility/">accessibility</a>, usability, and standards conformity.</p>
         <p>Efficient testing <strong>first</strong> leverages <strong>automated rule engines</strong> and corrects the defects that they discover, <strong>then</strong> employs human testers.</p>
-        <p>Choosing an automated rule engine is hard, because they <a href="https://www.w3.org/WAI/test-evaluate/tools/list/">are numerous</a> and <a href="https://arxiv.org/pdf/2304.07591">vary in what and how they test</a>.</p>
-        <p><strong>Ensemble testing</strong>, instead of choosing a rule engine, combines multiple rule engines. It can discover more issues than single-rule-engine testing, and the rule engines can check one another&rsquo;s quality.</p>
+        <p>Choosing among the <a href="https://www.w3.org/WAI/test-evaluate/tools/list/">many automated rule engines</a> is hard, because they <a href="https://arxiv.org/pdf/2304.07591">vary in what and how they test</a>.</p>
+        <p><strong>Ensemble testing</strong>, instead of choosing only one, combines <strong>multiple rule engines</strong>. It can discover more issues than single-rule-engine testing, and the rule engines can check one another&rsquo;s quality.</p>
         <h2>The rule engines</h2>
         <p>The Kilotest ensemble is <a href="https://github.com/jrpool/testaro?tab=readme-ov-file#dependencies">10 rule engines</a> developed by teams in the USA, Canada, Denmark, Australia, and Portugal.</p>
         <p>The rule engines perform about 1,300 tests in total. <a href="https://medium.com/cvs-health-tech-blog/how-to-run-a-thousand-accessibility-tests-63692ad120c3">Open-source software</a> developed initially at CVS Health drives the rule engines, tries to weed out invalid results, and distills the findings into about 350 <q>issues</q>.</p>
-        <h2>Status</h2>
-        <p>Kilotest is a proof of concept, launched in October 2025 and being actively developed. Your suggestions, bug reports, and collaboration proposals are welcome! Post them on <a href="https://github.com/jrpool/kilotest/issues">GitHub</a> or email them to <a href="mailto:info@kilotest.com">info@kilotest.com</a>.</p>
-        <p>In the current version, users can get results of already performed tests and can recommend new tests. Kilotest managers can approve recommendations.</p>
-        <h2 id="a11y">Accessibility</h2>
-        <p>Kilotest intends to be accessible. At a minimum, Kilotest intends to conform to the rules of the rule engines in the Kilotest ensemble. Those rules enforce various standards and best practices, including many success criteria of conformance levels AA and AAA of the <a href="https://www.w3.org/WAI/standards-guidelines/wcag/">Web Content Accessibility Guidelines (WCAG)</a>.</p>
-        <p>Humans and automated agents encountering any accessibility barriers during the use of Kilotest are encouraged to report them on <a href="https://github.com/jrpool/kilotest/issues">GitHub</a> or by email to <a href="mailto:info@kilotest.com">info@kilotest.com</a>.</p>
+        <h2>Features</h2>
+        <p>With Kilotest, you can get results of already performed tests and propose web pages for testing. (Immediate testing on request may become available in a future version.)</p>
+        <h2>How to use Kilotest</h2>
+        <h3>If you are a human user on the web</h3>
+        <p>You can use Kilotest starting on this page.</p>
+        <p>If your main interest is accessibility, feel free to learn more about it with our <a href="/tutorial.html">tutorial</a>.</p>
+        <h3>If you are a human user of AI</h3>
+        <p>An AI assistant can use the Kilotest MCP server to give you precise answers about the front-end quality of a web page. If the AI assistant does not already have permission to use Kilotest, you can grant that permission. <a href="https://kilotest.com/qai/">Learn how to connect AI platforms to Kilotest</a>.</p>
+        <h3>If you are an AI agent or model</h3>
+        <p>Go to the <a href="/mcp">Kilotest MCP server</a>.</p>
+        <h3>If you are developing an application</h3>
+        <p>Your application can use the Kilotest API, which has an <a href="/openapi.yaml">OpenAPI specification</a>.</p>
+        <h2>Comments?</h2>
+        <p>Your suggestions, bug reports, and collaboration proposals are welcome! Post them on <a href="https://github.com/jrpool/kilotest/issues">GitHub</a> or email them to <a href="mailto:info@kilotest.com">info@kilotest.com</a>.</p>
       </details>
       <h2>What do you want to know?</h2>
       <ul class="nav">

package/index.js

@@ -220,9 +220,7 @@ const getBasicAuth = request => {
   }
   return {id: decoded.slice(0, sepIndex), secret: decoded.slice(sepIndex + 1)};
 };
-// Gets the published name of the Testaro worker that made a request, or null if it is not
-// authenticated. The ID authenticates the worker and is never published; the name is a
-// non-secret label safe to write into job/report data and log messages.
+// Gets the published name of a Testaro worker or null if not authenticated.
 const getAuthorizedWorkerName = request => {
   const credentials = getBasicAuth(request);
   if (credentials) {

package/mcp.js

@@ -17,6 +17,7 @@ const listDiagnosesAPI = require('./api/listDiagnoses');
 const requestTestAPI = require('./api/requestTest');
 const requestRetestAPI = require('./api/requestRetest');
 const requestFeatureAPI = require('./api/requestFeature');
+const {version} = require('./api/version');
 
 const {
   getReportSchema,
@@ -46,7 +47,7 @@ exports.mcpPath = '/mcp';
 const createMCPServer = () => {
   const server = new McpServer({
     name: 'Kilotest',
-    version: '2.0.0',
+    version,
     description: 'Tools that test web pages for front-end quality (accessibility, usability, and standards conformity) and make test results available'
   },
   {

package/openapi.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.0
 info:
   title: Kilotest API
   description: 'Kilotest is an ensemble testing and reporting service for front-end web quality. It uses an ensemble of 10 rule engines to test public web pages for front-end quality (accessibility, usability, and standards conformity). Kilotest acts as a web server for human users, an MCP server for AI platforms, and an API for programmatic access. With this API you can request that a page be tested or retested, discover available reports, incrementally retrieve facts from a report: from what reports are available, to what issues were reported in one report, to what elements violated one issue, to what diagnoses rule engines gave for one violation.'
-  version: 39.0.3
+  version: 2.1.0
   license:
     name: MIT
     identifier: MIT
@@ -1100,7 +1100,7 @@ paths:
                       - closest ancestor request
                     additionalProperties: false
                   URLs of similar requests for web users:
-                    $ref: '#/components/schemas/SimilarWebRequests'
+                    type: 'null'
                   response metadata:
                     $ref: '#/components/schemas/ResponseMetadata'
                   response content:

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@jrpool/kilotest",
-  "version": "41.1.0",
+  "version": "42.0.2",
   "description": "Ensemble testing for front-end web quality",
   "main": "index.js",
+  "engines": {
+    "node": ">=22.12.0"
+  },
   "scripts": {
     "start": "node index",
     "lint": "npx eslint && npx markdownlint-cli2",
@@ -17,7 +20,10 @@
   "keywords": [
     "accessibility",
     "a11y",
-    "testing"
+    "testing",
+    "mcp",
+    "mcp-server",
+    "modelcontextprotocol"
   ],
   "author": "Jonathan Robert Pool <pool@jpdev.pro>",
   "license": "MIT",

package/scripts/generate-openapi.js

@@ -9,8 +9,9 @@ const fs = require('fs');
 const path = require('path');
 const yaml = require('js-yaml');
 const {createDocument} = require('zod-openapi');
-const {license, version} = require('../package.json');
+const {license} = require('../package.json');
 const routes = require('../api/routes');
+const {version} = require('../api/version');
 
 // CONSTANTS
 

package/server.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.jrpool/kilotest",
+  "description": "Ensemble testing of web pages for accessibility, usability, and standards conformity",
+  "repository": {
+    "url": "https://github.com/jrpool/kilotest",
+    "source": "github"
+  },
+  "version": "2.1.0",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://kilotest.com/mcp"
+    }
+  ],
+  "title": "Kilotest",
+  "websiteUrl": "https://kilotest.com"
+}

package/util.js

@@ -693,7 +693,7 @@ exports.getPageDataStrings = async (timeStamp, jobID, pageData) => {
     what,
     url,
     urlLink: `<a href="${url}">${url}</a>`,
-    testInfo: `Tested ${daysAgo} days ago by job <code>${jobID}</code> on ${when}`
+    testInfo: `Tested ${daysAgo === 1 ? '1 day' : `${daysAgo} days`} ago by job <code>${jobID}</code> on ${when}`
   };
 };
 // Returns the creation time and size of a report.