@atlaskit/ads-mcp 0.20.3 → 0.20.4

package/dist/esm/tools/analyze-a11y/list-analyze-localhost-a11y-tool.js

@@ -0,0 +1,14 @@
+import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
+import { analyzeA11yLocalhostInputSchema } from './analyze-a11y-localhost-input-schema';
+export var listAnalyzeLocalhostA11yTool = {
+  name: 'ads_analyze_localhost_a11y',
+  description: "Loads a **live URL** in a headless browser, runs **axe-core**, and returns violations with follow-up hints (often suggesting `ads_suggest_a11y_fixes`). Output is anchored in **axe** rule text; remediation may be generic or ADS-biased depending on the violation.\n\n**Availability:** This tool is only registered when the ADS MCP runs **on your machine** (local MCP). It is **not** available in the **remote** MCP offering\u2014use `ads_analyze_a11y` on source text there instead.\n\nWHEN TO USE:\nYou have a running app or storybook page and need automated accessibility results on **rendered** UI\u2014especially local or staging URLs.\n\nLIMITATIONS:\n- Does not replace manual testing with assistive technologies or keyboard-only navigation.\n- Requires network access to the URL from the environment running the MCP.",
+  annotations: {
+    title: 'Analyze accessibility (live URL)',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(analyzeA11yLocalhostInputSchema)
+};

package/dist/esm/tools/get-a11y-guidelines/get-a11y-guidelines-input-schema.js

@@ -0,0 +1,7 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+import { z } from 'zod';
+import { accessibilityGuidelines } from './guidelines';
+var topics = Object.keys(accessibilityGuidelines);
+export var getA11yGuidelinesInputSchema = z.object({
+  topic: z.string().optional().describe('ADS accessibility topic key. Omit to receive all topics and the full guideline bundle. Pass a valid key (see response \`availableTopics\`) or \`general\` for a focused overview when supported. Known topics: ' + topics.join(', ') + '.')
+});

package/dist/esm/tools/get-a11y-guidelines/{index.js → get-a11y-guidelines-tool.js}

@@ -5,25 +5,8 @@ function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbol
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
-import { z } from 'zod';
-import { zodToJsonSchema } from '../../helpers';
 import { accessibilityGuidelines } from './guidelines';
 var topics = Object.keys(accessibilityGuidelines);
-export var getA11yGuidelinesInputSchema = z.object({
-  topic: z.string().optional().describe('ADS accessibility topic key. Omit to receive all topics and the full guideline bundle. Pass a valid key (see response \`availableTopics\`) or \`general\` for a focused overview when supported. Known topics: ' + topics.join(', ') + '.')
-});
-export var listGetA11yGuidelinesTool = {
-  name: 'ads_get_a11y_guidelines',
-  description: "Returns Atlassian Design System (ADS) accessibility guidance: best practices and patterns for buttons, interactions, color contrast, forms, and other design-system topics shipped in this tool.\n\nUse this alongside the Context Engine MCP tool `get_accessibility_docs` for Atlassian-wide accessibility standards (e.g. A11YKB); this tool supplies ADS-specific component and pattern guidance.\n\nWHEN TO USE:\nYou MUST call this when generating or substantially changing a new interactive or visual user interface built with ADS, or when you need topic-specific ADS guidance (e.g. focus, forms, motion).\n\nDO NOT rely on generic web accessibility advice alone\u2014ADS conventions may differ. Use `get_accessibility_docs` for org-wide standards and this tool for ADS-topic guidance.",
-  annotations: {
-    title: 'Get ADS accessibility guidelines',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(getA11yGuidelinesInputSchema)
-};
 export var getA11yGuidelinesTool = /*#__PURE__*/function () {
   var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(_ref) {
     var topic, guidelines;

package/dist/esm/tools/get-a11y-guidelines/list-get-a11y-guidelines-tool.js

@@ -0,0 +1,16 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
+import { getA11yGuidelinesInputSchema } from './get-a11y-guidelines-input-schema';
+export var listGetA11yGuidelinesTool = {
+  name: 'ads_get_a11y_guidelines',
+  description: "Returns Atlassian Design System (ADS) accessibility guidance: best practices and patterns for buttons, interactions, color contrast, forms, and other design-system topics shipped in this tool.\n\nUse this alongside the Context Engine MCP tool `get_accessibility_docs` for Atlassian-wide accessibility standards (e.g. A11YKB); this tool supplies ADS-specific component and pattern guidance.\n\nWHEN TO USE:\nYou MUST call this when generating or substantially changing a new interactive or visual user interface built with ADS, or when you need topic-specific ADS guidance (e.g. focus, forms, motion).\n\nDO NOT rely on generic web accessibility advice alone\u2014ADS conventions may differ. Use `get_accessibility_docs` for org-wide standards and this tool for ADS-topic guidance.",
+  annotations: {
+    title: 'Get ADS accessibility guidelines',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(getA11yGuidelinesInputSchema)
+};

package/dist/esm/tools/get-all-components/{index.js → get-all-components-tool.js}

@@ -1,22 +1,7 @@
 import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
-
-import { z } from 'zod';
-import { zodToJsonSchema } from '../../helpers';
 import { loadAllComponents } from './load-all-components';
-export var listGetAllComponentsTool = {
-  name: 'ads_get_all_components',
-  description: "Returns **every** Atlassian Design System component record as separate JSON text chunks (full catalog; large payload).\n\nWHEN TO USE:\nLast resort when `ads_plan` / `ads_search_components` is insufficient and you must enumerate all components. Prefer search for normal component picking.\n\nNo parameters.",
-  annotations: {
-    title: 'Get all ADS components',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(z.object({}))
-};
 export var getAllComponentsTool = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
     return _regeneratorRuntime.wrap(function _callee$(_context) {

package/dist/esm/tools/get-all-components/list-get-all-components-tool.js

@@ -0,0 +1,16 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { z } from 'zod';
+import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
+export var listGetAllComponentsTool = {
+  name: 'ads_get_all_components',
+  description: "Returns **every** Atlassian Design System component record as separate JSON text chunks (full catalog; large payload).\n\nWHEN TO USE:\nLast resort when `ads_plan` / `ads_search_components` is insufficient and you must enumerate all components. Prefer search for normal component picking.\n\nNo parameters.",
+  annotations: {
+    title: 'Get all ADS components',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(z.object({}))
+};

package/dist/esm/tools/get-all-icons/{index.js → get-all-icons-tool.js}

@@ -1,22 +1,7 @@
 import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
-
-import { z } from 'zod';
-import { zodToJsonSchema } from '../../helpers';
 import { icons } from './icons';
-export var listGetAllIconsTool = {
-  name: 'ads_get_all_icons',
-  description: "Returns **every** ADS icon record as separate JSON text chunks (full catalog; large payload).\n\nWHEN TO USE:\nLast resort when `ads_plan` / `ads_search_icons` is insufficient and you must enumerate all icons. Prefer search for normal icon picking.\n\nNo parameters.",
-  annotations: {
-    title: 'Get all ADS icons',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(z.object({}))
-};
 export var getAllIconsTool = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
     return _regeneratorRuntime.wrap(function _callee$(_context) {

package/dist/esm/tools/get-all-icons/list-get-all-icons-tool.js

@@ -0,0 +1,16 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { z } from 'zod';
+import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
+export var listGetAllIconsTool = {
+  name: 'ads_get_all_icons',
+  description: "Returns **every** ADS icon record as separate JSON text chunks (full catalog; large payload).\n\nWHEN TO USE:\nLast resort when `ads_plan` / `ads_search_icons` is insufficient and you must enumerate all icons. Prefer search for normal icon picking.\n\nNo parameters.",
+  annotations: {
+    title: 'Get all ADS icons',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(z.object({}))
+};

package/dist/esm/tools/get-all-tokens/{index.js → get-all-tokens-tool.js}

@@ -1,23 +1,6 @@
 import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
-/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
-
-import { z } from 'zod';
 import { tokens } from '@atlaskit/tokens/token-metadata';
-import { zodToJsonSchema } from '../../helpers';
-var inputSchema = z.object({});
-export var listGetAllTokensTool = {
-  name: 'ads_get_all_tokens',
-  description: "Returns **every** ADS design token from bundled metadata (name, example value, usage guidelines)\u2014one JSON object per token, **very large** output.\n\nWHEN TO USE:\nLast resort when `ads_plan` / `ads_search_tokens` cannot answer the question and you need the full list (e.g. exhaustive audit). Prefer targeted search for normal development.\n\nNo parameters.",
-  annotations: {
-    title: 'Get all ADS tokens',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(inputSchema)
-};
 export var getAllTokensTool = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
     return _regeneratorRuntime.wrap(function _callee$(_context) {

package/dist/esm/tools/get-all-tokens/list-get-all-tokens-tool.js

@@ -0,0 +1,17 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { z } from 'zod';
+import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
+var inputSchema = z.object({});
+export var listGetAllTokensTool = {
+  name: 'ads_get_all_tokens',
+  description: "Returns **every** ADS design token from bundled metadata (name, example value, usage guidelines)\u2014one JSON object per token, **very large** output.\n\nWHEN TO USE:\nLast resort when `ads_plan` / `ads_search_tokens` cannot answer the question and you need the full list (e.g. exhaustive audit). Prefer targeted search for normal development.\n\nNo parameters.",
+  annotations: {
+    title: 'Get all ADS tokens',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(inputSchema)
+};