genat-mcp 2.2.1 → 2.2.2

package/README.md

@@ -110,7 +110,7 @@ If the global binary is not on PATH, use the full path, e.g. `node $(npm root -g
 ## Requirements
 
 - **Node.js** 20+
-- **n8n** with the [GenAT workflow](../workflows/genat-accessibility-tests-with-login.json) imported and activated (webhook path `webhook-test/webhook-genat-login`)
+- **n8n** with a GenAT workflow imported and activated. Use [genat-accessibility-tests-with-login-jira.json](../workflows/genat-accessibility-tests-with-login-jira.json) (path `webhook-test/webhook-genat-login-jira`) for JIRA support, or [genat-accessibility-tests-with-login.json](../workflows/genat-accessibility-tests-with-login.json) (path `webhook-test/webhook-genat-login`). Set **N8N_WEBHOOK_URL** to the workflow's webhook URL.
 - **DOM Analyzer** and **Accessibility Analyzer** services running (see main README: `npm run services` from repo root)
 
 ## Standalone script: run-genat.mjs
@@ -134,7 +134,7 @@ N8N_WEBHOOK_URL='https://your-n8n/webhook-test/webhook-genat-login' N8N_INSECURE
 N8N_MAX_ASSERTIONS=30 N8N_SCOPE_TO_REGIONS=header,main N8N_ANALYZE_STATES=1 node node_modules/genat-mcp/run-genat.mjs https://example.com .
 ```
 
-**Important:** Use `webhook-genat-login` (not `webhook-genat`). Import and activate [genat-accessibility-tests-with-login.json](../workflows/genat-accessibility-tests-with-login.json) in n8n.
+**Important:** Use `webhook-genat-login` or `webhook-genat-login-jira` (not `webhook-genat`). For JIRA support, import and activate [genat-accessibility-tests-with-login-jira.json](../workflows/genat-accessibility-tests-with-login-jira.json) and set N8N_WEBHOOK_URL to its webhook URL.
 
 **Optional – Cursor rule:** Copy the rule so the AI uses the correct webhook when creating workarounds (the MCP error responses also include this hint):
 ```bash
@@ -168,6 +168,7 @@ When creating run-genat.mjs: Use webhook-genat-login, NOT webhook-genat. Prefer
 - **loginUsername** (string, optional): Login username. Overrides .env when provided. Requires loginPassword.
 - **loginPassword** (string, optional): Login password. Overrides .env when provided. Requires loginUsername.
 - **loginUrl** (string, optional): Login page URL if different from target URL.
+- **jiraNumber** (string, optional): JIRA issue key (e.g. PROJ-123). When provided, the workflow fetches the issue and injects acceptance criteria into the AI prompt.
 
 Login credentials: provide in the prompt (loginUsername, loginPassword) or in project `.env` (TEST_USER, TEST_PASSWORD, LOGIN_USER, LOGIN_PASSWORD). Tool params override .env. For sensitive environments, prefer .env (gitignored) since credentials in the prompt are visible in chat history.
 
@@ -177,6 +178,8 @@ Generated tests include keyboard accessibility checks (Tab order, focus) by defa
 
 ## Sample prompts
 
+See [prompts.md](prompts.md) for a full list of prompts including specific parent folders, login, JIRA, and combined options.
+
 **With login credentials in the prompt:**
 
 ```
@@ -197,6 +200,16 @@ Use GenAT for https://myapp.example.com/dashboard. Credentials are in .env.
 Use GenAT to generate accessibility tests for https://myapp.example.com/dashboard using this project folder: . Write the files to the project.
 ```
 
+**With JIRA acceptance criteria:**
+
+```
+Use GenAT for https://myapp.example.com/dashboard with jiraNumber PROJ-123. Write the files to the project.
+```
+
+```
+Generate accessibility tests for https://example.com using JIRA ticket A11Y-456. Use parentProjectFolder . and writeToProject true.
+```
+
 ## Publishing to npm
 
 Until the package is published, `npm install genat-mcp` returns 404. To publish:

package/index.js

@@ -51,7 +51,7 @@ function insecureHttpsFetch(url, { method = 'GET', headers = {}, body }) {
 const server = new McpServer(
   {
     name: 'GenAT',
-    version: '2.2.1',
+    version: '2.2.2',
   },
   {
     capabilities: {
@@ -98,9 +98,13 @@ server.registerTool(
         .string()
         .optional()
         .describe('Login page URL if different from target URL'),
+      jiraNumber: z
+        .string()
+        .optional()
+        .describe('JIRA issue key (e.g. PROJ-123) for acceptance criteria'),
     },
   },
-  async ({ url, parentProjectFolder, writeToProject, maxAssertions, scopeToRegions, analyzeStates, loginUsername, loginPassword, loginUrl }) => {
+  async ({ url, parentProjectFolder, writeToProject, maxAssertions, scopeToRegions, analyzeStates, loginUsername, loginPassword, loginUrl, jiraNumber }) => {
     if (!url || typeof url !== 'string') {
       return {
         content: [{ type: 'text', text: JSON.stringify({ error: 'Missing or invalid "url"' }) }],
@@ -159,6 +163,7 @@ server.registerTool(
         ...(login.passwordSelector && { loginPasswordSelector: login.passwordSelector }),
         ...(login.submitSelector && { loginSubmitSelector: login.submitSelector }),
       }),
+      ...(jiraNumber && jiraNumber.trim() && { jiraNumber: jiraNumber.trim() }),
     };
 
     const useInsecureTls = N8N_INSECURE_TLS && N8N_WEBHOOK_URL.startsWith('https://');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genat-mcp",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "mcpName": "io.github.asokans@oclc.org/genat",
   "description": "MCP server GenAT: generate accessibility tests via n8n workflow (url + project folder)",
   "type": "module",