@atlaskit/ads-mcp 0.20.3 → 0.20.4

package/dist/cjs/tools/suggest-a11y-fixes/list-suggest-a11y-fixes-tool.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.listSuggestA11yFixesTool = void 0;
+var _zodToJsonSchema = require("../../helpers/zod-to-json-schema");
+var _suggestA11yFixesInputSchema = require("./suggest-a11y-fixes-input-schema");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var listSuggestA11yFixesTool = exports.listSuggestA11yFixesTool = {
+  name: 'ads_suggest_a11y_fixes',
+  description: "Suggests remediation steps for an accessibility issue described in natural language (often pasted from **axe-core**, ESLint, or review).\n\nWHAT YOU GET (varies by match):\n- **Curated hit:** ADS-biased examples and patterns from this server\u2019s recipe map (components, tokens, common fixes).\n- **No strong match:** Generic guidance (e.g. \u201Cuse ADS components\u201D, labeling, testing)\u2014still useful, but **not** guaranteed to be ADS-specific. May reference axe/atlassian.design resources.\n\nWHEN TO USE:\nAfter `ads_analyze_a11y` or `ads_analyze_localhost_a11y`, or whenever you have a violation string. For **topic-level** Atlassian Design System accessibility guidance, call `ads_get_a11y_guidelines` (this tool is fix-oriented, not a full guideline browse).\n\nDoes not replace manual testing with assistive technologies or keyboard-only navigation.",
+  annotations: {
+    title: 'Suggest accessibility fixes',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(_suggestA11yFixesInputSchema.suggestA11yFixesInputSchema)
+};

package/dist/cjs/tools/suggest-a11y-fixes/suggest-a11y-fixes-input-schema.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.suggestA11yFixesInputSchema = void 0;
+var _zod = require("zod");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var suggestA11yFixesInputSchema = exports.suggestA11yFixesInputSchema = _zod.z.object({
+  violation: _zod.z.string().describe('Human-readable description of the issue (e.g. axe rule help text, "button has no accessible name", "missing alt"). Used to match curated recipes when possible; otherwise the tool falls back to generic guidance.'),
+  code: _zod.z.string().describe('Snippet of the problematic code or markup so the response can be tailored (may be shown in the output for traceability).'),
+  component: _zod.z.string().optional().describe('Optional: React component name involved (e.g. `Button`, `TextField`)—may be ADS or app-specific.'),
+  context: _zod.z.string().optional().describe('Optional: where this appears (e.g. modal, table row, page section) or constraints.')
+});

package/dist/cjs/tools/suggest-a11y-fixes/{index.js → suggest-a11y-fixes-tool.js}

@@ -4,13 +4,11 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.suggestA11yFixesTool = exports.suggestA11yFixesInputSchema = exports.listSuggestA11yFixesTool = void 0;
+exports.suggestA11yFixesTool = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
-var _zod = require("zod");
-var _helpers = require("../../helpers");
 var _fixes = require("./fixes");
 var _keywords = require("./keywords");
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
@@ -18,25 +16,6 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
 function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; } /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
-var suggestA11yFixesInputSchema = exports.suggestA11yFixesInputSchema = _zod.z.object({
-  violation: _zod.z.string().describe('Human-readable description of the issue (e.g. axe rule help text, "button has no accessible name", "missing alt"). Used to match curated recipes when possible; otherwise the tool falls back to generic guidance.'),
-  code: _zod.z.string().describe('Snippet of the problematic code or markup so the response can be tailored (may be shown in the output for traceability).'),
-  component: _zod.z.string().optional().describe('Optional: React component name involved (e.g. `Button`, `TextField`)—may be ADS or app-specific.'),
-  context: _zod.z.string().optional().describe('Optional: where this appears (e.g. modal, table row, page section) or constraints.')
-});
-var listSuggestA11yFixesTool = exports.listSuggestA11yFixesTool = {
-  name: 'ads_suggest_a11y_fixes',
-  description: "Suggests remediation steps for an accessibility issue described in natural language (often pasted from **axe-core**, ESLint, or review).\n\nWHAT YOU GET (varies by match):\n- **Curated hit:** ADS-biased examples and patterns from this server\u2019s recipe map (components, tokens, common fixes).\n- **No strong match:** Generic guidance (e.g. \u201Cuse ADS components\u201D, labeling, testing)\u2014still useful, but **not** guaranteed to be ADS-specific. May reference axe/atlassian.design resources.\n\nWHEN TO USE:\nAfter `ads_analyze_a11y` or `ads_analyze_localhost_a11y`, or whenever you have a violation string. For **topic-level** Atlassian Design System accessibility guidance, call `ads_get_a11y_guidelines` (this tool is fix-oriented, not a full guideline browse).\n\nDoes not replace manual testing with assistive technologies or keyboard-only navigation.",
-  annotations: {
-    title: 'Suggest accessibility fixes',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: (0, _helpers.zodToJsonSchema)(suggestA11yFixesInputSchema)
-};
-
 // Keyword mappings for fuzzy matching - imported from keywords.ts
 // This allows flexible user input when describing accessibility violations
 

package/dist/es2019/entry-points/analyze-a11y.js

@@ -0,0 +1,5 @@
+export { analyzeA11yInputSchema } from '../tools/analyze-a11y/analyze-a11y-input-schema';
+export { listAnalyzeA11yTool } from '../tools/analyze-a11y/list-analyze-a11y-tool';
+export { analyzeA11yLocalhostInputSchema } from '../tools/analyze-a11y/analyze-a11y-localhost-input-schema';
+export { listAnalyzeLocalhostA11yTool } from '../tools/analyze-a11y/list-analyze-localhost-a11y-tool';
+export { analyzeA11yTool } from '../tools/analyze-a11y/analyze-a11y-tool';

package/dist/es2019/entry-points/get-a11y-guidelines.js

@@ -0,0 +1,3 @@
+export { getA11yGuidelinesInputSchema } from '../tools/get-a11y-guidelines/get-a11y-guidelines-input-schema';
+export { listGetA11yGuidelinesTool } from '../tools/get-a11y-guidelines/list-get-a11y-guidelines-tool';
+export { getA11yGuidelinesTool } from '../tools/get-a11y-guidelines/get-a11y-guidelines-tool';

package/dist/es2019/entry-points/get-all-components.js

@@ -0,0 +1,2 @@
+export { listGetAllComponentsTool } from '../tools/get-all-components/list-get-all-components-tool';
+export { getAllComponentsTool } from '../tools/get-all-components/get-all-components-tool';

package/dist/es2019/entry-points/get-all-icons.js

@@ -0,0 +1,2 @@
+export { listGetAllIconsTool } from '../tools/get-all-icons/list-get-all-icons-tool';
+export { getAllIconsTool } from '../tools/get-all-icons/get-all-icons-tool';

package/dist/es2019/entry-points/get-all-tokens.js

@@ -0,0 +1,2 @@
+export { listGetAllTokensTool } from '../tools/get-all-tokens/list-get-all-tokens-tool';
+export { getAllTokensTool } from '../tools/get-all-tokens/get-all-tokens-tool';

package/dist/es2019/entry-points/get-atlaskit-components.js

@@ -0,0 +1,2 @@
+export { listGetAtlaskitComponentsTool } from '../tools/get-atlaskit-components/list-get-atlaskit-components-tool';
+export { getAtlaskitComponentsTool } from '../tools/get-atlaskit-components/get-atlaskit-components-tool';

package/dist/es2019/entry-points/get-guidelines.js

@@ -0,0 +1,3 @@
+export { listGetGuidelinesTool } from '../tools/get-guidelines/list-get-guidelines-tool';
+export { getGuidelinesTool } from '../tools/get-guidelines/get-guidelines-tool';
+export { getGuidelinesInputSchema } from '../tools/get-guidelines/get-guidelines-input-schema';

package/dist/es2019/entry-points/get-lint-rules.js

@@ -0,0 +1,3 @@
+export { getLintRulesInputSchema } from '../tools/get-lint-rules/get-lint-rules-input-schema';
+export { listGetLintRulesTool } from '../tools/get-lint-rules/list-get-lint-rules-tool';
+export { getLintRulesTool } from '../tools/get-lint-rules/get-lint-rules-tool';

package/dist/es2019/entry-points/i18n-conversion.js

@@ -0,0 +1,3 @@
+export { i18nConversionInputSchema } from '../tools/i18n-conversion/i18n-conversion-input-schema';
+export { listI18nConversionTool } from '../tools/i18n-conversion/list-i18n-conversion-tool';
+export { i18nConversionTool } from '../tools/i18n-conversion/i18n-conversion-tool';

package/dist/es2019/entry-points/migration-guides.js

@@ -0,0 +1,3 @@
+export { migrationGuidesInputSchema } from '../tools/migration-guides/migration-guides-input-schema';
+export { listMigrationGuidesTool } from '../tools/migration-guides/list-migration-guides-tool';
+export { migrationGuidesTool } from '../tools/migration-guides/migration-guides-tool';

package/dist/es2019/entry-points/plan.js

@@ -0,0 +1,3 @@
+export { planInputSchema } from '../tools/plan/plan-input-schema';
+export { listPlanTool } from '../tools/plan/list-plan-tool';
+export { planTool } from '../tools/plan/plan-tool';

package/dist/es2019/entry-points/search-atlaskit-components.js

@@ -0,0 +1,3 @@
+export { searchAtlaskitComponentsInputSchema } from '../tools/search-atlaskit-components/search-atlaskit-components-input-schema';
+export { listSearchAtlaskitComponentsTool } from '../tools/search-atlaskit-components/list-search-atlaskit-components-tool';
+export { searchAtlaskitComponentsTool } from '../tools/search-atlaskit-components/search-atlaskit-components-tool';

package/dist/es2019/entry-points/search-components.js

@@ -0,0 +1,3 @@
+export { searchComponentsInputSchema } from '../tools/search-components/search-components-input-schema';
+export { listSearchComponentsTool } from '../tools/search-components/list-search-components-tool';
+export { searchComponentsTool } from '../tools/search-components/search-components-tool';

package/dist/es2019/entry-points/search-icons.js

@@ -0,0 +1,3 @@
+export { searchIconsInputSchema } from '../tools/search-icons/search-icons-input-schema';
+export { listSearchIconsTool } from '../tools/search-icons/list-search-icons-tool';
+export { searchIconsTool } from '../tools/search-icons/search-icons-tool';

package/dist/es2019/entry-points/search-tokens.js

@@ -0,0 +1,3 @@
+export { searchTokensInputSchema } from '../tools/search-tokens/search-tokens-input-schema';
+export { listSearchTokensTool } from '../tools/search-tokens/list-search-tokens-tool';
+export { searchTokensTool } from '../tools/search-tokens/search-tokens-tool';

package/dist/es2019/entry-points/suggest-a11y-fixes.js

@@ -0,0 +1,3 @@
+export { suggestA11yFixesInputSchema } from '../tools/suggest-a11y-fixes/suggest-a11y-fixes-input-schema';
+export { listSuggestA11yFixesTool } from '../tools/suggest-a11y-fixes/list-suggest-a11y-fixes-tool';
+export { suggestA11yFixesTool } from '../tools/suggest-a11y-fixes/suggest-a11y-fixes-tool';

package/dist/es2019/helpers/agent.js

@@ -0,0 +1,3 @@
+/* eslint-disable no-console */
+
+export const agent = process.env.ADSMCP_AGENT || 'unknown';

package/dist/es2019/helpers/clean-query.js

@@ -0,0 +1,2 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+export const cleanQuery = query => query.trim().toLowerCase().replace(/\s+/g, '');

package/dist/es2019/helpers/index.js

@@ -1,8 +1,3 @@
-/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
-
-import { zodToJsonSchema as zodToJsonSchemaHelper } from 'zod-to-json-schema';
 export { computeMultiTermFuseAllocation, mergeMultiTermFuseResults } from './fuse-multi-term';
-export const cleanQuery = query => query.trim().toLowerCase().replace(/\s+/g, '');
-export const zodToJsonSchema = (schema, options) => {
-  return zodToJsonSchemaHelper(schema, options);
-};
+export { cleanQuery } from './clean-query';
+export { zodToJsonSchema } from './zod-to-json-schema';

package/dist/es2019/helpers/send-operational-event.js

@@ -0,0 +1,49 @@
+/* eslint-disable no-console */
+
+import { agent } from './agent';
+import { configPath } from './config-path';
+import { staffId } from './staff-id';
+
+// eslint-disable-next-line import/no-extraneous-dependencies -- this uses require because not all node versions this package supports use the same import assertions/attributes
+const pkgJson = require('@atlaskit/ads-mcp/package.json');
+const version = pkgJson.version || '0.0.0-unknown';
+let analyticsClient = null;
+/**
+ * Send an operational event to analytics
+ * Wraps the analytics client and handles errors gracefully
+ * If analytics client is not available, this function is a no-op
+ */
+export function sendOperationalEvent({
+  action,
+  actionSubject,
+  actionSubjectId = '',
+  attributes = {}
+}) {
+  // If analytics client is not available, skip analytics
+  if (!analyticsClient) {
+    return;
+  }
+  try {
+    analyticsClient.sendOperationalEvent({
+      anonymousId: 'unknown',
+      operationalEvent: {
+        action,
+        actionSubject,
+        actionSubjectId,
+        source: '@atlaskit/ads-mcp',
+        tags: ['ads-mcp'],
+        attributes: {
+          version,
+          staffId,
+          agent,
+          configPath,
+          ...attributes
+        }
+      }
+    });
+  } catch {
+    // Analytics errors should not prevent normal operation
+    // Silently fail to avoid disrupting the main functionality
+    console.error('Error sending operational event to analytics');
+  }
+}

package/dist/es2019/helpers/validation.js

@@ -1,6 +1,6 @@
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
-import { zodToJsonSchema } from './index';
+import { zodToJsonSchema } from './zod-to-json-schema';
 /**
  * Validates arguments against a Zod schema and returns a discriminated union result.
  *

package/dist/es2019/helpers/zod-to-json-schema.js

@@ -0,0 +1,6 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { zodToJsonSchema as zodToJsonSchemaHelper } from 'zod-to-json-schema';
+export const zodToJsonSchema = (schema, options) => {
+  return zodToJsonSchemaHelper(schema, options);
+};

package/dist/es2019/index.js

@@ -2,23 +2,56 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { sendOperationalEvent } from './helpers/analytics';
+import { sendOperationalEvent } from './helpers/send-operational-event';
 import { validateToolArguments } from './helpers/validation';
 import { instructions } from './instructions';
-import { analyzeA11yInputSchema, analyzeA11yLocalhostInputSchema, analyzeA11yTool, analyzeLocalhostA11yTool, listAnalyzeA11yTool, listAnalyzeLocalhostA11yTool } from './tools/analyze-a11y';
-import { getA11yGuidelinesInputSchema, getA11yGuidelinesTool, listGetA11yGuidelinesTool } from './tools/get-a11y-guidelines';
-import { getAllComponentsTool, listGetAllComponentsTool } from './tools/get-all-components';
-import { getAllIconsTool, listGetAllIconsTool } from './tools/get-all-icons';
-import { getAllTokensTool, listGetAllTokensTool } from './tools/get-all-tokens';
-import { getGuidelinesInputSchema, getGuidelinesTool, listGetGuidelinesTool } from './tools/get-guidelines';
-import { getLintRulesInputSchema, getLintRulesTool, listGetLintRulesTool } from './tools/get-lint-rules';
-import { i18nConversionInputSchema, i18nConversionTool, listI18nConversionTool } from './tools/i18n-conversion';
-import { listMigrationGuidesTool, migrationGuidesInputSchema, migrationGuidesTool } from './tools/migration-guides';
-import { listPlanTool, planInputSchema, planTool } from './tools/plan';
-import { listSearchComponentsTool, searchComponentsInputSchema, searchComponentsTool } from './tools/search-components';
-import { listSearchIconsTool, searchIconsInputSchema, searchIconsTool } from './tools/search-icons';
-import { listSearchTokensTool, searchTokensInputSchema, searchTokensTool } from './tools/search-tokens';
-import { listSuggestA11yFixesTool, suggestA11yFixesInputSchema, suggestA11yFixesTool } from './tools/suggest-a11y-fixes';
+import { analyzeA11yInputSchema } from './tools/analyze-a11y/analyze-a11y-input-schema';
+import { analyzeA11yLocalhostInputSchema } from './tools/analyze-a11y/analyze-a11y-localhost-input-schema';
+import { analyzeA11yTool } from './tools/analyze-a11y/analyze-a11y-tool';
+import { analyzeLocalhostA11yTool } from './tools/analyze-a11y/analyze-localhost-a11y-tool';
+import { listAnalyzeA11yTool } from './tools/analyze-a11y/list-analyze-a11y-tool';
+import { listAnalyzeLocalhostA11yTool } from './tools/analyze-a11y/list-analyze-localhost-a11y-tool';
+import { getA11yGuidelinesInputSchema } from './tools/get-a11y-guidelines/get-a11y-guidelines-input-schema';
+import { getA11yGuidelinesTool } from './tools/get-a11y-guidelines/get-a11y-guidelines-tool';
+import { listGetA11yGuidelinesTool } from './tools/get-a11y-guidelines/list-get-a11y-guidelines-tool';
+import { getAllComponentsTool } from './tools/get-all-components/get-all-components-tool';
+import { listGetAllComponentsTool } from './tools/get-all-components/list-get-all-components-tool';
+import { getAllIconsTool } from './tools/get-all-icons/get-all-icons-tool';
+import { listGetAllIconsTool } from './tools/get-all-icons/list-get-all-icons-tool';
+import { getAllTokensTool } from './tools/get-all-tokens/get-all-tokens-tool';
+import { listGetAllTokensTool } from './tools/get-all-tokens/list-get-all-tokens-tool';
+import { getAtlaskitComponentsTool } from './tools/get-atlaskit-components/get-atlaskit-components-tool';
+import { listGetAtlaskitComponentsTool } from './tools/get-atlaskit-components/list-get-atlaskit-components-tool';
+import { getGuidelinesInputSchema } from './tools/get-guidelines/get-guidelines-input-schema';
+import { getGuidelinesTool } from './tools/get-guidelines/get-guidelines-tool';
+import { listGetGuidelinesTool } from './tools/get-guidelines/list-get-guidelines-tool';
+import { getLintRulesInputSchema } from './tools/get-lint-rules/get-lint-rules-input-schema';
+import { getLintRulesTool } from './tools/get-lint-rules/get-lint-rules-tool';
+import { listGetLintRulesTool } from './tools/get-lint-rules/list-get-lint-rules-tool';
+import { i18nConversionInputSchema } from './tools/i18n-conversion/i18n-conversion-input-schema';
+import { i18nConversionTool } from './tools/i18n-conversion/i18n-conversion-tool';
+import { listI18nConversionTool } from './tools/i18n-conversion/list-i18n-conversion-tool';
+import { listMigrationGuidesTool } from './tools/migration-guides/list-migration-guides-tool';
+import { migrationGuidesInputSchema } from './tools/migration-guides/migration-guides-input-schema';
+import { migrationGuidesTool } from './tools/migration-guides/migration-guides-tool';
+import { listPlanTool } from './tools/plan/list-plan-tool';
+import { planInputSchema } from './tools/plan/plan-input-schema';
+import { planTool } from './tools/plan/plan-tool';
+import { listSearchAtlaskitComponentsTool } from './tools/search-atlaskit-components/list-search-atlaskit-components-tool';
+import { searchAtlaskitComponentsInputSchema } from './tools/search-atlaskit-components/search-atlaskit-components-input-schema';
+import { searchAtlaskitComponentsTool } from './tools/search-atlaskit-components/search-atlaskit-components-tool';
+import { listSearchComponentsTool } from './tools/search-components/list-search-components-tool';
+import { searchComponentsInputSchema } from './tools/search-components/search-components-input-schema';
+import { searchComponentsTool } from './tools/search-components/search-components-tool';
+import { listSearchIconsTool } from './tools/search-icons/list-search-icons-tool';
+import { searchIconsInputSchema } from './tools/search-icons/search-icons-input-schema';
+import { searchIconsTool } from './tools/search-icons/search-icons-tool';
+import { listSearchTokensTool } from './tools/search-tokens/list-search-tokens-tool';
+import { searchTokensInputSchema } from './tools/search-tokens/search-tokens-input-schema';
+import { searchTokensTool } from './tools/search-tokens/search-tokens-tool';
+import { listSuggestA11yFixesTool } from './tools/suggest-a11y-fixes/list-suggest-a11y-fixes-tool';
+import { suggestA11yFixesInputSchema } from './tools/suggest-a11y-fixes/suggest-a11y-fixes-input-schema';
+import { suggestA11yFixesTool } from './tools/suggest-a11y-fixes/suggest-a11y-fixes-tool';
 
 // eslint-disable-next-line import/no-extraneous-dependencies -- this uses require because not all node versions this package supports use the same import assertions/attributes
 const pkgJson = require('@atlaskit/ads-mcp/package.json');
@@ -48,83 +81,96 @@ const generateLogger = level => (...args) => {
     console.error(`[ads-mcp.custom-logging][${level}]`, ...args);
   }
 };
-export const getToolRegistry = () => ({
-  [listAnalyzeA11yTool.name]: {
-    handler: analyzeA11yTool,
-    inputSchema: analyzeA11yInputSchema,
-    tool: listAnalyzeA11yTool
-  },
-  [listAnalyzeLocalhostA11yTool.name]: {
-    handler: analyzeLocalhostA11yTool,
-    inputSchema: analyzeA11yLocalhostInputSchema,
-    tool: listAnalyzeLocalhostA11yTool
-  },
-  [listGetA11yGuidelinesTool.name]: {
-    handler: getA11yGuidelinesTool,
-    inputSchema: getA11yGuidelinesInputSchema,
-    tool: listGetA11yGuidelinesTool
-  },
-  [listGetAllComponentsTool.name]: {
-    handler: getAllComponentsTool,
-    inputSchema: null,
-    tool: listGetAllComponentsTool
-  },
-  [listPlanTool.name]: {
-    handler: planTool,
-    inputSchema: planInputSchema,
-    tool: listPlanTool
-  },
-  [listSearchComponentsTool.name]: {
-    handler: searchComponentsTool,
-    inputSchema: searchComponentsInputSchema,
-    tool: listSearchComponentsTool
-  },
-  [listSearchIconsTool.name]: {
-    handler: searchIconsTool,
-    inputSchema: searchIconsInputSchema,
-    tool: listSearchIconsTool
-  },
-  [listSearchTokensTool.name]: {
-    handler: searchTokensTool,
-    inputSchema: searchTokensInputSchema,
-    tool: listSearchTokensTool
-  },
-  [listSuggestA11yFixesTool.name]: {
-    handler: suggestA11yFixesTool,
-    inputSchema: suggestA11yFixesInputSchema,
-    tool: listSuggestA11yFixesTool
-  },
-  [listMigrationGuidesTool.name]: {
-    handler: migrationGuidesTool,
-    inputSchema: migrationGuidesInputSchema,
-    tool: listMigrationGuidesTool
-  },
-  [listI18nConversionTool.name]: {
-    handler: i18nConversionTool,
-    inputSchema: i18nConversionInputSchema,
-    tool: listI18nConversionTool
-  },
-  [listGetGuidelinesTool.name]: {
-    handler: getGuidelinesTool,
-    inputSchema: getGuidelinesInputSchema,
-    tool: listGetGuidelinesTool
-  },
-  [listGetAllTokensTool.name]: {
-    handler: getAllTokensTool,
-    inputSchema: null,
-    tool: listGetAllTokensTool
-  },
-  [listGetAllIconsTool.name]: {
-    handler: getAllIconsTool,
-    inputSchema: null,
-    tool: listGetAllIconsTool
-  },
-  [listGetLintRulesTool.name]: {
-    handler: getLintRulesTool,
-    inputSchema: getLintRulesInputSchema,
-    tool: listGetLintRulesTool
-  }
-});
+export const getToolRegistry = () => {
+  const registry = {
+    [listAnalyzeA11yTool.name]: {
+      handler: analyzeA11yTool,
+      inputSchema: analyzeA11yInputSchema,
+      tool: listAnalyzeA11yTool
+    },
+    [listAnalyzeLocalhostA11yTool.name]: {
+      handler: analyzeLocalhostA11yTool,
+      inputSchema: analyzeA11yLocalhostInputSchema,
+      tool: listAnalyzeLocalhostA11yTool
+    },
+    [listGetA11yGuidelinesTool.name]: {
+      handler: getA11yGuidelinesTool,
+      inputSchema: getA11yGuidelinesInputSchema,
+      tool: listGetA11yGuidelinesTool
+    },
+    [listGetAllComponentsTool.name]: {
+      handler: getAllComponentsTool,
+      inputSchema: null,
+      tool: listGetAllComponentsTool
+    },
+    [listPlanTool.name]: {
+      handler: planTool,
+      inputSchema: planInputSchema,
+      tool: listPlanTool
+    },
+    [listSearchComponentsTool.name]: {
+      handler: searchComponentsTool,
+      inputSchema: searchComponentsInputSchema,
+      tool: listSearchComponentsTool
+    },
+    [listSearchIconsTool.name]: {
+      handler: searchIconsTool,
+      inputSchema: searchIconsInputSchema,
+      tool: listSearchIconsTool
+    },
+    [listSearchTokensTool.name]: {
+      handler: searchTokensTool,
+      inputSchema: searchTokensInputSchema,
+      tool: listSearchTokensTool
+    },
+    [listSuggestA11yFixesTool.name]: {
+      handler: suggestA11yFixesTool,
+      inputSchema: suggestA11yFixesInputSchema,
+      tool: listSuggestA11yFixesTool
+    },
+    [listMigrationGuidesTool.name]: {
+      handler: migrationGuidesTool,
+      inputSchema: migrationGuidesInputSchema,
+      tool: listMigrationGuidesTool
+    },
+    [listI18nConversionTool.name]: {
+      handler: i18nConversionTool,
+      inputSchema: i18nConversionInputSchema,
+      tool: listI18nConversionTool
+    },
+    [listGetGuidelinesTool.name]: {
+      handler: getGuidelinesTool,
+      inputSchema: getGuidelinesInputSchema,
+      tool: listGetGuidelinesTool
+    },
+    [listGetAllTokensTool.name]: {
+      handler: getAllTokensTool,
+      inputSchema: null,
+      tool: listGetAllTokensTool
+    },
+    [listGetAllIconsTool.name]: {
+      handler: getAllIconsTool,
+      inputSchema: null,
+      tool: listGetAllIconsTool
+    },
+    [listGetLintRulesTool.name]: {
+      handler: getLintRulesTool,
+      inputSchema: getLintRulesInputSchema,
+      tool: listGetLintRulesTool
+    },
+    [listGetAtlaskitComponentsTool.name]: {
+      handler: getAtlaskitComponentsTool,
+      inputSchema: null,
+      tool: listGetAtlaskitComponentsTool
+    },
+    [listSearchAtlaskitComponentsTool.name]: {
+      handler: searchAtlaskitComponentsTool,
+      inputSchema: searchAtlaskitComponentsInputSchema,
+      tool: listSearchAtlaskitComponentsTool
+    }
+  };
+  return registry;
+};
 server.setRequestHandler(ListToolsRequestSchema, async (request, extra) => {
   const toolRegistry = getToolRegistry();
   const tools = Object.values(toolRegistry).map(toolConfig => toolConfig.tool);

package/dist/es2019/tools/analyze-a11y/analyze-a11y-input-schema.js

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export const analyzeA11yInputSchema = z.object({
+  code: z.string().describe('Source code of a React component or JSX snippet to analyze (string content only—no file path).'),
+  componentName: z.string().optional().describe('Optional label for the component under review (for summaries and reports).'),
+  context: z.string().optional().describe('Optional: how the component is used (e.g. in a form, modal) to improve suggestions.'),
+  includePatternAnalysis: z.boolean().default(true).describe('When true (default), runs regex-based heuristics on the code string (e.g. unlabeled buttons, missing alt) in addition to other analysis.').optional()
+});

package/dist/es2019/tools/analyze-a11y/analyze-a11y-localhost-input-schema.js

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export const analyzeA11yLocalhostInputSchema = z.object({
+  url: z.string().describe('Fully qualified page URL to load (e.g. `http://localhost:9000` or a dev URL). Must be reachable from this MCP process.'),
+  componentName: z.string().optional().describe('Optional label for reporting (e.g. feature or component under test).'),
+  context: z.string().optional().describe('Optional: route, user flow, or feature context for the analyzed page.'),
+  selector: z.string().optional().describe('Optional CSS selector to scope axe analysis to a subtree (e.g. `#my-form`, `[data-testid="panel"]`). Omit to analyze the whole document.')
+});