accessflow-mcp-server 1.0.14 → 1.1.0-beta.0

package/dist/utils/domains.js

@@ -0,0 +1,14 @@
+export const sanitizeDomain = (domain) => {
+    if (!domain)
+        return '';
+    domain = domain.trim();
+    domain = domain.replace(/^https?:\/\//, '');
+    domain = domain.replace(/^www\./, '');
+    const slashIndex = domain.indexOf('/');
+    if (slashIndex !== -1) {
+        domain = domain.slice(0, slashIndex);
+    }
+    domain = domain.replace(/\.+$/, '');
+    return domain;
+};
+//# sourceMappingURL=domains.js.map

package/dist/utils/domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../src/utils/domains.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAU,EAAE;IACvD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAEvB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAE5C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEtC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEpC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/utils/issues.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Utility functions for working with accessibility issues
+ */
+/**
+ * Normalizes severity to uppercase string
+ */
+export declare function normalizeSeverity(severity?: string): string;
+/**
+ * Normalizes WCAG level or returns default
+ */
+export declare function normalizeWCAGLevel(wcagLevel?: string): string;
+/**
+ * Normalizes criteria or returns default
+ */
+export declare function normalizeCriteria(criteria?: string): string;
+//# sourceMappingURL=issues.d.ts.map

package/dist/utils/issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/utils/issues.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/utils/issues.js

@@ -0,0 +1,24 @@
+/**
+ * Utility functions for working with accessibility issues
+ */
+/**
+ * Normalizes severity to uppercase string
+ */
+export function normalizeSeverity(severity) {
+    if (!severity)
+        return 'UNKNOWN';
+    return severity.toUpperCase();
+}
+/**
+ * Normalizes WCAG level or returns default
+ */
+export function normalizeWCAGLevel(wcagLevel) {
+    return wcagLevel || 'Unknown';
+}
+/**
+ * Normalizes criteria or returns default
+ */
+export function normalizeCriteria(criteria) {
+    return criteria || 'Unknown';
+}
+//# sourceMappingURL=issues.js.map

package/dist/utils/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../src/utils/issues.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAiB;IACjD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAkB;IACnD,OAAO,SAAS,IAAI,SAAS,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAiB;IACjD,OAAO,QAAQ,IAAI,SAAS,CAAC;AAC/B,CAAC"}

package/dist/utils/middleware.d.ts

@@ -0,0 +1,14 @@
+import type { Tool } from 'fastmcp';
+/**
+ * Checks if domain and API key are configured
+ */
+export declare function hasValidCredentials(domain: string, apiKey: string): boolean;
+/**
+ * Returns the registration message when credentials are missing
+ */
+export declare function getRegistrationMessage(): string;
+/**
+ * Wraps a tool's execute function with credential validation middleware
+ */
+export declare function withCredentialCheck(domain: string, apiKey: string, tool: Tool<any, any>): Tool<any, any>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/utils/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/utils/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,SAAS,CAAC;AAE7C;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAQ/C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GACnB,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAiBhB"}

package/dist/utils/middleware.js

@@ -0,0 +1,37 @@
+/**
+ * Checks if domain and API key are configured
+ */
+export function hasValidCredentials(domain, apiKey) {
+    return Boolean(domain && domain.trim() && apiKey && apiKey.trim());
+}
+/**
+ * Returns the registration message when credentials are missing
+ */
+export function getRegistrationMessage() {
+    return `Unlock full accessibility guidance!
+
+It looks like you don't have an active accessFlow license or API key yet.
+
+Get instant access to remediation insights and fix accessibility issues right from VS Code, powered by accessFlow's accessibility engine.
+
+Register now to activate your license and start improving accessibility today.`;
+}
+/**
+ * Wraps a tool's execute function with credential validation middleware
+ */
+export function withCredentialCheck(domain, apiKey, tool) {
+    const originalExecute = tool.execute;
+    if (!originalExecute) {
+        throw new Error('Tool must have an execute function');
+    }
+    return {
+        ...tool,
+        execute: async (args, context) => {
+            if (!hasValidCredentials(domain, apiKey)) {
+                return getRegistrationMessage();
+            }
+            return originalExecute(args, context);
+        },
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/utils/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/utils/middleware.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,MAAc;IAChE,OAAO,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;;;;;;+EAMsE,CAAC;AAChF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,MAAc,EACd,IAAoB;IAEpB,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC;IAErC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO;QACL,GAAG,IAAI;QACP,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,OAAqB,EAAE,EAAE;YACtD,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;gBACzC,OAAO,sBAAsB,EAAE,CAAC;YAClC,CAAC;YAED,OAAO,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/remediation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Utility functions for formatting remediation responses
+ */
+import type { ApiIssueRemediation, ApiRule } from '../types/remediation.js';
+/**
+ * Extracts related rule ID from various formats
+ */
+export declare function extractRuleId(relatedRuleId?: string | {
+    $oid: string;
+} | {
+    toString: () => string;
+}): string | null;
+/**
+ * Extracts date from various formats
+ */
+export declare function extractDate(date?: {
+    $date: number;
+} | number | string): Date;
+/**
+ * Extracts code blocks from HTML resolution
+ */
+export declare function extractCodeBlocks(htmlResolution: string): string[];
+/**
+ * Formats the remediation response as markdown
+ */
+export declare function formatRemediationResponse(issue: ApiIssueRemediation, rule?: ApiRule | null): string;
+//# sourceMappingURL=remediation.d.ts.map

package/dist/utils/remediation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remediation.d.ts","sourceRoot":"","sources":["../../src/utils/remediation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAE5E;;GAEG;AACH,wBAAgB,aAAa,CAC3B,aAAa,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;CAAE,GACrE,MAAM,GAAG,IAAI,CAuBf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAc5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAclE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,IAAI,GAAE,OAAO,GAAG,IAAW,GAC1B,MAAM,CAgGR"}

package/dist/utils/remediation.js

@@ -0,0 +1,139 @@
+/**
+ * Utility functions for formatting remediation responses
+ */
+/**
+ * Extracts related rule ID from various formats
+ */
+export function extractRuleId(relatedRuleId) {
+    if (!relatedRuleId) {
+        return null;
+    }
+    if (typeof relatedRuleId === 'string') {
+        return relatedRuleId;
+    }
+    if (typeof relatedRuleId === 'object') {
+        if ('$oid' in relatedRuleId) {
+            return relatedRuleId.$oid;
+        }
+        if ('toString' in relatedRuleId &&
+            typeof relatedRuleId.toString === 'function') {
+            return relatedRuleId.toString();
+        }
+    }
+    return null;
+}
+/**
+ * Extracts date from various formats
+ */
+export function extractDate(date) {
+    if (!date) {
+        return new Date();
+    }
+    if (typeof date === 'number' || typeof date === 'string') {
+        return new Date(date);
+    }
+    if (typeof date === 'object' && '$date' in date) {
+        return new Date(date.$date);
+    }
+    return new Date();
+}
+/**
+ * Extracts code blocks from HTML resolution
+ */
+export function extractCodeBlocks(htmlResolution) {
+    const codeBlocks = htmlResolution.match(/<pre[^>]*><code[^>]*>(.*?)<\/code><\/pre>/gs) || [];
+    return codeBlocks.map((block) => {
+        return block
+            .replace(/<pre[^>]*><code[^>]*>/, '')
+            .replace(/<\/code><\/pre>/, '')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&amp;/g, '&')
+            .trim();
+    });
+}
+/**
+ * Formats the remediation response as markdown
+ */
+export function formatRemediationResponse(issue, rule = null) {
+    // 1. Short summary of the problem
+    const summary = rule?.shortDescription ||
+        `Accessibility issue detected: ${issue.displayName}`;
+    // 2. WCAG reference & severity
+    const wcagLevel = issue.WCAGLevel || 'Unknown';
+    const severity = issue.severity?.toUpperCase() || 'Unknown';
+    const criteria = issue.criteria || 'Unknown';
+    const wcagLink = rule?.issueWCAGLink || '';
+    // 3. Code-level fix suggestions
+    let codeFix = '\n## Code-Level Fix\n\n';
+    if (rule) {
+        codeFix += rule.shortDescription
+            ? `**Solution:** ${rule.shortDescription}\n\n`
+            : '';
+        // Show the current problematic code
+        if (issue.HTML) {
+            codeFix += '**Current code:**\n```html\n' + issue.HTML + '\n```\n\n';
+        }
+        // Extract code examples from the HTML resolution if available
+        if (rule.issueResolution) {
+            const codeBlocks = extractCodeBlocks(rule.issueResolution);
+            if (codeBlocks.length > 0) {
+                codeBlocks.forEach((cleanCode, index) => {
+                    codeFix += `**Suggested fix ${index + 1}:**\n\`\`\`html\n${cleanCode}\n\`\`\`\n\n`;
+                });
+            }
+        }
+        // Add suggested fix details if available
+        if (rule.suggestedFix && rule.suggestedFix.length > 0) {
+            codeFix += '**Quick Fix Suggestions:**\n';
+            rule.suggestedFix.forEach((fix, index) => {
+                codeFix += `${index + 1}. **${fix.suggestedFixType || 'Fix'}**: `;
+                if (fix.suggestedFixKey) {
+                    codeFix += `Add attribute \`${fix.suggestedFixKey}="${fix.suggestedFixValue}"\`\n`;
+                }
+                else {
+                    codeFix += `${fix.suggestedFixValue || 'N/A'}\n`;
+                }
+            });
+            codeFix += '\n';
+        }
+    }
+    else {
+        codeFix += 'No specific rule found for this issue.\n\n';
+    }
+    // 4. Links back to remediation panel
+    const issueDate = extractDate(issue.date ||
+        issue.modified);
+    const confidence = issue.confidence ?? 0;
+    const occurrences = issue.occurrences ?? 0;
+    const webpath = issue.webpath || 'N/A';
+    const selector = issue.selector || 'N/A';
+    const remediationLinks = `
+## 📚 Additional Resources
+
+- **WCAG Reference:** ${wcagLink
+        ? `[${wcagLevel} - ${criteria}](${wcagLink})`
+        : `${wcagLevel} - ${criteria}`}
+- **Tutorial:** ${rule?.issueTutorialLink || 'Contact your AccessFlow administrator'}
+- **Issue Location:** ${webpath} (Selector: \`${selector}\`)
+- **AccessFlow Panel:** View full remediation details in your AccessFlow dashboard
+
+---
+**Issue ID:** ${issue.displayName} | **Detected:** ${issueDate.toLocaleDateString()} | **Confidence:** ${confidence}%`;
+    return `# ${summary}
+
+## WCAG Reference & Severity
+
+- **Severity:** ${severity}
+- **WCAG Level:** ${wcagLevel}
+- **Criteria:** ${criteria}
+- **Occurrences:** ${occurrences} time(s) on this page
+
+${codeFix}
+
+${remediationLinks}
+
+After fixing the issue, call the tool resolveIssue with issueDisplayName parameter of the issue that was fixed.`;
+}
+//# sourceMappingURL=remediation.js.map

package/dist/utils/remediation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remediation.js","sourceRoot":"","sources":["../../src/utils/remediation.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const sanitizeDomain: (domain: string) => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAiB/C,CAAC"}

package/dist/utils.js

@@ -0,0 +1,14 @@
+export const sanitizeDomain = (domain) => {
+    if (!domain)
+        return '';
+    domain = domain.trim();
+    domain = domain.replace(/^https?:\/\//, '');
+    domain = domain.replace(/^www\./, '');
+    const slashIndex = domain.indexOf('/');
+    if (slashIndex !== -1) {
+        domain = domain.slice(0, slashIndex);
+    }
+    domain = domain.replace(/\.+$/, '');
+    return domain;
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAU,EAAE;IACvD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAEvB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAE5C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEtC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEpC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/package.json

@@ -1,31 +1,65 @@
 {
   "name": "accessflow-mcp-server",
-  "version": "1.0.14",
+  "version": "1.1.0-beta.0",
+  "type": "module",
   "description": "AccessFlow MCP Server for accessibility issue remediation",
-  "main": "build/index.js",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
   "bin": {
-    "flow-mcp": "./bin/flow-mcp"
+    "accessflow-mcp-server": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
   },
   "scripts": {
-    "build": "tsc",
-    "start": "node build/index.js",
-    "dev": "tsc && node build/index.js",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "dev": "tsx src/index.ts",
+    "build": "tsc && rm -rf dist/data && cp -r src/data dist/data 2>/dev/null || true && rm -rf dist/**/__tests__ dist/**/*.test.js dist/**/*.test.d.ts dist/**/*.test.js.map dist/**/*.test.d.ts.map 2>/dev/null || true",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json,md}\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "keywords": [
     "mcp",
     "accessibility",
     "wcag",
-    "remediation"
+    "remediation",
+    "accessflow",
+    "mcp-server"
   ],
   "author": "AccessFlow",
   "license": "ISC",
-  "type": "module",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.15.1"
-  },
   "devDependencies": {
-    "@types/node": "^24.0.14",
-    "typescript": "^5.8.3"
+    "@types/node": "^24.10.1",
+    "@typescript-eslint/eslint-plugin": "^8.46.4",
+    "@typescript-eslint/parser": "^8.46.4",
+    "@vitest/coverage-v8": "^2.1.8",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "pino-pretty": "^13.1.2",
+    "prettier": "^3.6.2",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.8"
+  },
+  "dependencies": {
+    "dotenv": "^17.2.3",
+    "fastmcp": "^3.23.0",
+    "pino": "^10.1.0"
   }
 }

package/TOOL_REFERENCE.md

@@ -1,126 +0,0 @@
-# AccessFlow MCP Tools
-
-Quick reference for MCP clien## Tool: `getMostUrgentIssues`
-
-Get the 10 most critical accessibility issues prioritized by severity, then by site occurrences, then by page occurrences for the configured website.
-
-**Parameters:** None (uses configured WEBSITE_ID)
-
-**Prioritization Logic:**
-
-1. **Primary**: Severity (EXTREME > HIGH > MEDIUM > LOW)
-2. **Secondary**: Site occurrences (how many locations on the site)
-3. **Tertiary**: Page occurrences (how many times on the current page)
-
-**Example:**
-
-```json
-{
-  "tool": "getMostUrgentIssues",
-  "arguments": {}
-}
-```
-
-**Returns:** Prioritized list with issue IDs, severity levels, occurrence counts, and locations for the configured website.accessibility tools.
-
-## Configuration
-
-The MCP server requires these environment variables:
-
-- `MONGO_URI`: MongoDB connection string
-- `WEBSITE_ID`: The website ID to filter accessibility issues for
-
-Example MCP configuration:
-
-```json
-{
-  "mcp": {
-    "servers": {
-      "flow-mcp": {
-        "command": "node",
-        "args": ["/path/to/flow-mcp/build/index.js"],
-        "env": {
-          "MONGO_URI": "mongodb://localhost:27017/accessflow",
-          "WEBSITE_ID": "68790033a1951a20af80f22b"
-        }
-      }
-    }
-  }
-}
-```
-
-## Tool: `getIssueRemediation`
-
-Get detailed fix guidance for a specific accessibility issue from the configured website.
-
-**Parameters:**
-
-- `issueDisplayName` (string, required): Issue ID from AccessFlow
-
-**Example:**
-
-```json
-{
-  "tool": "getIssueRemediation",
-  "arguments": {
-    "issueDisplayName": "Untagged-Headings-276b188870"
-  }
-}
-```
-
-**Returns:** Remediation guide with WCAG references, code examples, and fix instructions. Returns an error if the issue doesn't belong to the configured website.
-
-## Tool: `getMostUrgentIssues`
-
-Get the 10 most critical accessibility issues prioritized by severity.
-
-**Parameters:**
-
-- `website_id` (string, required): The website ID to get issues for. Only issues from this specific website will be returned.
-
-**Example:**
-
-```json
-{
-  "tool": "getMostUrgentIssues",
-  "arguments": {
-    "website_id": "68790033a1951a20af80f22b"
-  }
-}
-```
-
-**Returns:** Prioritized list with issue IDs, severity levels, and locations.
-
-## Workflow
-
-1. **Get priorities:** `getMostUrgentIssues` → See which issues need attention first (filtered to configured website)
-2. **Get fix details:** `getIssueRemediation` with specific issue IDs → Get step-by-step remediation
-3. **Fix in order:** Start with EXTREME severity, then HIGH → MEDIUM → LOW
-
-## Getting Website ID
-
-You can find your website ID using the flow-db-mcp tool:
-
-```json
-{
-  "tool": "readDocuments",
-  "arguments": {
-    "collectionName": "websites",
-    "projection": { "_id": 1, "domain": 1, "name": 1 }
-  }
-}
-```
-
-## Severity Levels
-
-- 🔴 **EXTREME** - Critical accessibility barriers
-- 🟠 **HIGH** - Significant usability issues
-- 🟡 **MEDIUM** - Moderate accessibility concerns
-- 🟢 **LOW** - Minor improvements needed
-
-## Error Handling
-
-- Invalid issue ID → Returns "Issue Not Found" message
-- Website ID mismatch → Returns "Website Mismatch Error" message
-- Database connection issues → Returns connection error
-- Missing parameters → Returns parameter validation error

package/bin/flow-mcp

@@ -1,4 +0,0 @@
-#!/usr/bin/env node
-import { AccessFlowMCPServer } from "../build/index.js";
-const server = new AccessFlowMCPServer();
-server.run().catch(console.error);

package/build/index.d.ts

@@ -1,12 +0,0 @@
-#!/usr/bin/env node
-export declare class AccessFlowMCPServer {
-    private server;
-    private environment;
-    private domain;
-    private apiKey;
-    private rules;
-    constructor();
-    private setupToolHandlers;
-    run(): Promise<void>;
-}
-//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAeA,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAoB;;IAmCjC,OAAO,CAAC,iBAAiB;IAiDnB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB3B"}

package/build/index.js

@@ -1,95 +0,0 @@
-#!/usr/bin/env node
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
-import rulesData from "./rules.json" with { type: "json" };
-import { getToolDefinitions, getToolHandler } from "./tools/index.js";
-import { sanitizeDomain } from "./utils/domain.js";
-export class AccessFlowMCPServer {
-    server;
-    environment;
-    domain;
-    apiKey;
-    rules = rulesData;
-    constructor() {
-        this.server = new Server({
-            name: "flow-mcp",
-            version: "1.0.0",
-        }, {
-            capabilities: {
-                tools: {},
-            },
-        });
-        this.environment = process.env.ENVIRONMENT || "https://accessflow.accessibe.com";
-        // Get DOMAIN Key from environment variable
-        this.domain = sanitizeDomain(process.env.DOMAIN || "");
-        if (!this.domain) {
-            console.error("DOMAIN environment variable is required");
-            process.exit(1);
-        }
-        // Get API Key from environment variable
-        this.apiKey = process.env.API_KEY || "";
-        if (!this.apiKey) {
-            console.error("API_KEY environment variable is required");
-            process.exit(1);
-        }
-        this.setupToolHandlers();
-    }
-    setupToolHandlers() {
-        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
-            return {
-                tools: getToolDefinitions(),
-            };
-        });
-        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-            const { name, arguments: args } = request.params;
-            try {
-                const handler = getToolHandler(name);
-                if (!handler) {
-                    throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
-                }
-                const headers = {
-                    "x-api-key": this.apiKey,
-                    "x-accessflow-domain": this.domain,
-                    "Content-Type": "application/json",
-                };
-                if (this.environment.toLowerCase().includes("test")) {
-                    const basicAuth = Buffer.from("test:acsb123").toString("base64");
-                    headers["Authorization"] = `Basic ${basicAuth}`;
-                }
-                const context = {
-                    rules: this.rules,
-                    environment: this.environment,
-                    apiKey: this.apiKey,
-                    headers: headers,
-                };
-                return await handler(args || {}, context);
-            }
-            catch (error) {
-                if (error instanceof McpError) {
-                    throw error;
-                }
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${errorMessage}`);
-            }
-        });
-    }
-    async run() {
-        const transport = new StdioServerTransport();
-        await this.server.connect(transport);
-        console.error("AccessFlow MCP Server running on stdio");
-        // Handle graceful shutdown
-        process.on("SIGINT", async () => {
-            console.error("Shutting down AccessFlow MCP Server...");
-            process.exit(0);
-        });
-        process.on("SIGTERM", async () => {
-            console.error("Shutting down AccessFlow MCP Server...");
-            process.exit(0);
-        });
-    }
-}
-// Start the server
-const server = new AccessFlowMCPServer();
-server.run().catch(console.error);
-//# sourceMappingURL=index.js.map