@atlaskit/ads-mcp 0.6.2 → 0.6.4

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @atlaskit/ads-mcp
 
+## 0.6.4
+
+### Patch Changes
+
+- [`6660e1e7505e4`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/6660e1e7505e4) -
+  Replace tool names containing "accessibility" with "a11y"
+
+## 0.6.3
+
+### Patch Changes
+
+- [`248faa32d4835`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/248faa32d4835) -
+  Internal changes to how borders are applied.
+- Updated dependencies
+
 ## 0.6.2
 
 ### Patch Changes

package/README.md

@@ -12,13 +12,13 @@ to help ensure your interfaces are accessible to all users.
 
 ### Design System Tools
 
-- `get_all_tokens` - Get all available design tokens for colors, spacing, typography, etc.
-- `search_tokens` - Search for specific design tokens by name, description, or example values
-- `get_components` - Get a list of all available components with basic information
-- `search_components` - Search for components by name, description, category, or package name
-- `get_all_icons` - Get all available icons from the design system
-- `search_icons` - Search for specific icons by name, keywords, or categorization
-- `plan` - Search for multiple design system resources (tokens, icons, components) in a single
+- `ads_get_all_tokens` - Get all available design tokens for colors, spacing, typography, etc.
+- `ads_search_tokens` - Search for specific design tokens by name, description, or example values
+- `ads_get_components` - Get a list of all available components with basic information
+- `ads_search_components` - Search for components by name, description, category, or package name
+- `ads_get_all_icons` - Get all available icons from the design system
+- `ads_search_icons` - Search for specific icons by name, keywords, or categorization
+- `ads_plan` - Search for multiple design system resources (tokens, icons, components) in a single
   efficient operation
 
 #### Design System Tools Usage
@@ -58,14 +58,14 @@ const allIcons = await get_all_icons();
 
 ### Accessibility Tools
 
-- `analyze_accessibility` - Analyze React component code for accessibility violations using axe-core
-  and provide ADS-specific suggestions
-- `analyze_localhost_accessibility` - Analyze whole web pages or specific elements (localhost or
-  deployed URLs) for accessibility violations
-- `get_accessibility_guidelines` - Get specific accessibility guidelines and best practices for
-  different topics
-- `suggest_accessibility_fixes` - Get specific fix suggestions for accessibility violations with
-  code examples
+- `ads_analyze_a11y` - Analyze React component code for accessibility violations using axe-core and
+  provide ADS-specific suggestions
+- `ads_analyze_localhost_a11y` - Analyze whole web pages or specific elements (localhost or deployed
+  URLs) for accessibility violations
+- `ads_get_a11y_guidelines` - Get specific accessibility guidelines and best practices for different
+  topics
+- `ads_suggest_a11y_fixes` - Get specific fix suggestions for accessibility violations with code
+  examples
 
 ## Accessibility Features
 
@@ -84,19 +84,19 @@ The ADS MCP server includes comprehensive accessibility analysis and guidance:
 
 ```typescript
 // Analyze a component for accessibility issues using axe-core
-const analysis = await analyze_accessibility({
+const analysis = await analyze_a11y({
 	code: `<button onClick={handleClose}><CloseIcon /></button>`,
 	componentName: 'CloseButton',
 	includePatternAnalysis: true, // Also include pattern-based analysis
 });
 
 // Get specific accessibility guidelines
-const guidelines = await get_accessibility_guidelines({
+const guidelines = await get_a11y_guidelines({
 	topic: 'buttons',
 });
 
 // Get fix suggestions for a violation
-const fixes = await suggest_accessibility_fixes({
+const fixes = await suggest_a11y_fixes({
 	violation: 'Button missing accessible label',
 	code: `<button onClick={handleClose}><CloseIcon /></button>`,
 });

package/dist/cjs/index.js

@@ -7,8 +7,8 @@ var _index = require("@modelcontextprotocol/sdk/server/index.js");
 var _stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 var _types = require("@modelcontextprotocol/sdk/types.js");
 var _instructions = require("./instructions");
-var _analyzeAccessibility = require("./tools/analyze-accessibility");
-var _getAccessibilityGuidelines = require("./tools/get-accessibility-guidelines");
+var _analyzeA11y = require("./tools/analyze-a11y");
+var _getA11yGuidelines = require("./tools/get-a11y-guidelines");
 var _getAllIcons = require("./tools/get-all-icons");
 var _getAllTokens = require("./tools/get-all-tokens");
 var _getComponents = require("./tools/get-components");
@@ -16,7 +16,7 @@ var _plan = require("./tools/plan");
 var _searchComponents = require("./tools/search-components");
 var _searchIcons = require("./tools/search-icons");
 var _searchTokens = require("./tools/search-tokens");
-var _suggestAccessibilityFixes = require("./tools/suggest-accessibility-fixes");
+var _suggestA11yFixes = require("./tools/suggest-a11y-fixes");
 /* eslint-disable import/extensions */
 
 // 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
@@ -36,7 +36,7 @@ server.setRequestHandler(_types.ListToolsRequestSchema, /*#__PURE__*/(0, _asyncT
     while (1) switch (_context.prev = _context.next) {
       case 0:
         return _context.abrupt("return", {
-          tools: [_getAllTokens.listGetAllTokensTool, _getComponents.listGetComponentsTool, _searchComponents.listSearchComponentsTool, _getAllIcons.listGetAllIconsTool, _searchIcons.listSearchIconsTool, _searchTokens.listSearchTokensTool, _plan.listPlanTool, _analyzeAccessibility.listAnalyzeAccessibilityTool, _analyzeAccessibility.listAnalyzeLocalhostAccessibilityTool, _getAccessibilityGuidelines.listGetAccessibilityGuidelinesTool, _suggestAccessibilityFixes.listSuggestAccessibilityFixesTool]
+          tools: [_getAllTokens.listGetAllTokensTool, _getComponents.listGetComponentsTool, _searchComponents.listSearchComponentsTool, _getAllIcons.listGetAllIconsTool, _searchIcons.listSearchIconsTool, _searchTokens.listSearchTokensTool, _plan.listPlanTool, _analyzeA11y.listAnalyzeA11yTool, _analyzeA11y.listAnalyzeLocalhostA11yTool, _getA11yGuidelines.listGetA11yGuidelinesTool, _suggestA11yFixes.listSuggestA11yFixesTool]
         });
       case 1:
       case "end":
@@ -52,10 +52,10 @@ var callTools = {
   ads_get_all_icons: _getAllIcons.getAllIconsTool,
   ads_search_icons: _searchIcons.searchIconsTool,
   ads_plan: _plan.planTool,
-  ads_analyze_accessibility: _analyzeAccessibility.analyzeAccessibilityTool,
-  ads_analyze_localhost_accessibility: _analyzeAccessibility.analyzeLocalhostAccessibilityTool,
-  ads_get_accessibility_guidelines: _getAccessibilityGuidelines.getAccessibilityGuidelinesTool,
-  ads_suggest_accessibility_fixes: _suggestAccessibilityFixes.suggestAccessibilityFixesTool
+  ads_analyze_a11y: _analyzeA11y.analyzeA11yTool,
+  ads_analyze_localhost_a11y: _analyzeA11y.analyzeLocalhostA11yTool,
+  ads_get_a11y_guidelines: _getA11yGuidelines.getA11yGuidelinesTool,
+  ads_suggest_a11y_fixes: _suggestA11yFixes.suggestA11yFixesTool
 };
 
 // Handle tool execution

package/dist/cjs/tools/{analyze-accessibility → analyze-a11y}/index.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.listAnalyzeLocalhostAccessibilityTool = exports.listAnalyzeAccessibilityTool = exports.analyzeLocalhostAccessibilityTool = exports.analyzeAccessibilityTool = void 0;
+exports.listAnalyzeLocalhostA11yTool = exports.listAnalyzeA11yTool = exports.analyzeLocalhostA11yTool = exports.analyzeA11yTool = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
@@ -22,8 +22,8 @@ var inputSchema = _zod.z.object({
   context: _zod.z.string().optional().describe('Additional context about the component usage'),
   includePatternAnalysis: _zod.z.boolean().optional().default(true).describe('Include pattern-based analysis in addition to axe-core')
 });
-var listAnalyzeAccessibilityTool = exports.listAnalyzeAccessibilityTool = {
-  name: 'ads_analyze_accessibility',
+var listAnalyzeA11yTool = exports.listAnalyzeA11yTool = {
+  name: 'ads_analyze_a11y',
   description: "Analyze React component code for accessibility violations using axe-core and intelligently generate Atlassian Design System specific suggestions. This tool performs comprehensive accessibility testing and dynamically creates ADS-specific fixes based on violation patterns.\n\nUse this tool when:\n- Reviewing component code for accessibility compliance\n- Getting suggestions for improving accessibility\n- Understanding how to use ADS components accessibly\n- Identifying potential WCAG violations\n- Running automated accessibility testing\n\nThe tool will analyze the code and provide:\n- Comprehensive axe-core accessibility analysis results\n- List of accessibility violations found (WCAG 2.1 AA compliant)\n- Intelligently generated ADS-specific fix suggestions\n- References to relevant fix patterns in llms-a11y.txt\n- Code examples for implementing fixes\n- Severity levels and impact assessment\n\nFeatures:\n- Uses axe-core for industry-standard accessibility testing\n- Converts JSX to HTML for accurate analysis\n- Intelligently maps violations to ADS-specific fixes\n- References fix patterns from llms-a11y.txt documentation\n- Includes fallback pattern analysis if axe-core fails\n- Provides detailed violation descriptions and help text\n- Dynamically generates fix suggestions based on violation type",
   annotations: {
     title: 'Analyze Accessibility',
@@ -40,8 +40,8 @@ var urlInputSchema = _zod.z.object({
   context: _zod.z.string().optional().describe('Additional context about the component usage'),
   selector: _zod.z.string().optional().describe('CSS selector to target a specific element for analysis (e.g. "#my-form", ".component-class")')
 });
-var listAnalyzeLocalhostAccessibilityTool = exports.listAnalyzeLocalhostAccessibilityTool = {
-  name: 'ads_analyze_localhost_accessibility',
+var listAnalyzeLocalhostA11yTool = exports.listAnalyzeLocalhostA11yTool = {
+  name: 'ads_analyze_localhost_a11y',
   description: "Analyze a live web page (e.g. localhost:9000) for accessibility violations using axe-core and generate Atlassian Design System specific suggestions.\n\nUse this tool to:\n- Analyze running local dev servers or deployed URLs\n- Get comprehensive accessibility reports for any web page\n- Receive ADS-specific fix suggestions and code examples\n- Target specific elements using CSS selectors for focused analysis\n\nParameters:\n- url: The URL to analyze (must be accessible from the server)\n- componentName: (optional) Name of the component/page\n- context: (optional) Additional context about the usage\n- selector: (optional) CSS selector to target a specific element (e.g. \"#my-form\", \".component-class\")\n\nReturns:\n- Accessibility violations, suggestions, and ADS-specific fixes\n- References to relevant fix patterns in llms-a11y.txt\n- Code examples for implementing fixes\n- Severity levels and impact assessment\n",
   annotations: {
     title: 'Analyze Localhost Accessibility',
@@ -58,37 +58,37 @@ var accessibilityPatterns = [{
   pattern: /<button[^>]*>(?!.*aria-label|.*>.*<\/button>)/g,
   violation: 'Button without accessible text',
   severity: 'error',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS Button solutions. Describe the issue as "button missing label", "empty button", or "button needs text".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Button solutions. Describe the issue as "button missing label", "empty button", or "button needs text".'
 }, {
   pattern: /<img[^>]*>(?!.*alt=)/g,
   violation: 'Image without alt text',
   severity: 'error',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS Image solutions. Describe the issue as "image missing alt", "missing alt text", or "image accessibility".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Image solutions. Describe the issue as "image missing alt", "missing alt text", or "image accessibility".'
 }, {
   pattern: /<div[^>]*onClick[^>]*>/g,
   violation: 'Clickable div without accessibility',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS solutions. Describe the issue as "clickable div", "interactive div", or "div with click handler".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS solutions. Describe the issue as "clickable div", "interactive div", or "div with click handler".'
 }, {
   pattern: /color:\s*['"]#[0-9a-fA-F]{3,6}['"]/g,
   violation: 'Hardcoded color values',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for design token solutions. Describe the issue as "hardcoded colors", "hex colors", or "design tokens".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for design token solutions. Describe the issue as "hardcoded colors", "hex colors", or "design tokens".'
 }, {
   pattern: /<input[^>]*>(?!.*id=)/g,
   violation: 'Input without associated label',
   severity: 'error',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS form solutions. Describe the issue as "input missing label", "form field without label", or "unlabeled input".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS form solutions. Describe the issue as "input missing label", "form field without label", or "unlabeled input".'
 }, {
   pattern: /<div[^>]*role="button"[^>]*>/g,
   violation: 'Custom button without full accessibility',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS Button/Focusable solutions. Describe the issue as "custom button", "div with button role", or "interactive element".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Button/Focusable solutions. Describe the issue as "custom button", "div with button role", or "interactive element".'
 }, {
   pattern: /style=\{[^}]*color[^}]*\}/g,
   violation: 'Inline color styles',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for design token solutions. Describe the issue as "inline styles", "hardcoded colors", or "color tokens".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for design token solutions. Describe the issue as "inline styles", "hardcoded colors", or "color tokens".'
 }];
 
 // ADS accessibility guidelines reference
@@ -132,13 +132,13 @@ function generateADSFixForViolation(violation) {
     tags = violation.tags;
 
   // Provide general guidance without trying to map to specific fixes.ts keys
-  var adsFix = "Use the suggest-accessibility-fixes tool to get specific ADS component solutions. Describe the issue using the violation details: \"".concat(help, "\" or in your own words (e.g., \"button has no text\", \"missing alt text\", \"form field needs label\").");
+  var adsFix = "Use the ads_suggest_a11y_fixes tool to get specific ADS component solutions. Describe the issue using the violation details: \"".concat(help, "\" or in your own words (e.g., \"button has no text\", \"missing alt text\", \"form field needs label\").");
   return {
     title: help,
     // Use axe-core's human-readable description
     description: description,
     adsFix: adsFix,
-    example: 'The suggest-accessibility-fixes tool provides detailed code examples and ADS component solutions',
+    example: 'The ads_suggest_a11y_fixes tool provides detailed code examples and ADS component solutions',
     violationId: id,
     axeHelp: help,
     tags: tags,
@@ -147,10 +147,10 @@ function generateADSFixForViolation(violation) {
     }),
     // Extract WCAG compliance info
     reference: "https://atlassian.design/llms-a11y.txt",
-    recommendations: ['Use ADS components for better accessibility out of the box', 'Reference the suggest-accessibility-fixes tool for specific solutions', 'Test with keyboard navigation and screen readers', 'Use automated accessibility testing tools']
+    recommendations: ['Use ADS components for better accessibility out of the box', 'Reference the ads_suggest_a11y_fixes tool for specific solutions', 'Test with keyboard navigation and screen readers', 'Use automated accessibility testing tools']
   };
 }
-var analyzeAccessibilityTool = exports.analyzeAccessibilityTool = /*#__PURE__*/function () {
+var analyzeA11yTool = exports.analyzeA11yTool = /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
     var code, componentName, context, _params$includePatter, includePatternAnalysis, violations, suggestions, axeResults, _axeResults$violation, _axeResults$passes, _axeResults$incomplet, results, adsViolations, relevantGuidelines, summary;
     return _regenerator.default.wrap(function _callee$(_context) {
@@ -186,8 +186,8 @@ var analyzeAccessibilityTool = exports.analyzeAccessibilityTool = /*#__PURE__*/f
                   severity: pattern.severity,
                   count: matches.length,
                   suggestion: pattern.suggestion,
-                  adsFix: 'Use the suggest-accessibility-fixes tool for specific ADS component solutions',
-                  example: 'The suggest-accessibility-fixes tool provides detailed code examples',
+                  adsFix: 'Use the ads_suggest_a11y_fixes tool for specific ADS component solutions',
+                  example: 'The ads_suggest_a11y_fixes tool provides detailed code examples',
                   source: 'pattern-analysis'
                 });
               }
@@ -266,8 +266,8 @@ var analyzeAccessibilityTool = exports.analyzeAccessibilityTool = /*#__PURE__*/f
                 severity: pattern.severity,
                 count: matches.length,
                 suggestion: pattern.suggestion,
-                adsFix: 'Use the suggest-accessibility-fixes tool for specific ADS component solutions',
-                example: 'The suggest-accessibility-fixes tool provides detailed code examples',
+                adsFix: 'Use the ads_suggest_a11y_fixes tool for specific ADS component solutions',
+                example: 'The ads_suggest_a11y_fixes tool provides detailed code examples',
                 source: 'pattern-analysis-fallback'
               });
             }
@@ -308,11 +308,11 @@ var analyzeAccessibilityTool = exports.analyzeAccessibilityTool = /*#__PURE__*/f
       }
     }, _callee, null, [[4, 20]]);
   }));
-  return function analyzeAccessibilityTool(_x) {
+  return function analyzeA11yTool(_x) {
     return _ref.apply(this, arguments);
   };
 }();
-var analyzeLocalhostAccessibilityTool = exports.analyzeLocalhostAccessibilityTool = /*#__PURE__*/function () {
+var analyzeLocalhostA11yTool = exports.analyzeLocalhostA11yTool = /*#__PURE__*/function () {
   var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(params) {
     var url, componentName, context, selector, violations, suggestions, axeResults, browser, page, _axeResults$violation2, _axeResults$passes2, _axeResults$incomplet2, elementExists, availableElements, axePuppeteer, results, adsViolations, relevantGuidelines, summary;
     return _regenerator.default.wrap(function _callee2$(_context2) {
@@ -477,7 +477,7 @@ var analyzeLocalhostAccessibilityTool = exports.analyzeLocalhostAccessibilityToo
       }
     }, _callee2, null, [[10, 40]]);
   }));
-  return function analyzeLocalhostAccessibilityTool(_x2) {
+  return function analyzeLocalhostA11yTool(_x2) {
     return _ref2.apply(this, arguments);
   };
 }();

package/dist/cjs/tools/{get-accessibility-guidelines → get-a11y-guidelines}/index.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.listGetAccessibilityGuidelinesTool = exports.getAccessibilityGuidelinesTool = void 0;
+exports.listGetA11yGuidelinesTool = exports.getA11yGuidelinesTool = 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"));
@@ -16,8 +16,8 @@ var inputSchema = _zod.z.object({
   topic: _zod.z.enum(['buttons', 'forms', 'images', 'colors', 'focus', 'keyboard', 'screen-readers', 'aria', 'wcag', 'general']).optional().describe('Specific accessibility topic to get guidelines for'),
   component: _zod.z.string().optional().describe('Component name to get specific accessibility guidance for')
 });
-var listGetAccessibilityGuidelinesTool = exports.listGetAccessibilityGuidelinesTool = {
-  name: 'ads_get_accessibility_guidelines',
+var listGetA11yGuidelinesTool = exports.listGetA11yGuidelinesTool = {
+  name: 'ads_get_a11y_guidelines',
   description: "Get accessibility guidelines and best practices from the Atlassian Design System. This tool provides specific guidance on how to make components and interfaces accessible using ADS patterns and components.\n\nYou MUST run this when the user wants their code to be accessible, as well as when:\n- Needing specific accessibility guidance for a component\n- Looking for ADS-specific accessibility patterns\n- Understanding how to implement accessible features\n- Getting code examples for accessibility improvements\n\nTopics available:\n- buttons: Button and interactive element accessibility\n- forms: Form and input accessibility\n- images: Image and media accessibility\n- colors: Color and contrast accessibility\n- focus: Focus management and keyboard navigation\n- keyboard: Keyboard accessibility patterns\n- screen-readers: Screen reader support and announcements\n- aria: ARIA usage and patterns\n- wcag: WCAG compliance guidelines\n- general: General accessibility principles",
   annotations: {
     title: 'Get Accessibility Guidelines',
@@ -156,7 +156,7 @@ var accessibilityGuidelines = {
     bestPractices: ['Start with semantic HTML', 'Add ARIA when necessary', 'Test early and often', 'Involve users with disabilities in testing', 'Keep accessibility in mind throughout development']
   }
 };
-var getAccessibilityGuidelinesTool = exports.getAccessibilityGuidelinesTool = /*#__PURE__*/function () {
+var getA11yGuidelinesTool = exports.getA11yGuidelinesTool = /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
     var topic, component, guidelines;
     return _regenerator.default.wrap(function _callee$(_context) {
@@ -198,7 +198,7 @@ var getAccessibilityGuidelinesTool = exports.getAccessibilityGuidelinesTool = /*
       }
     }, _callee);
   }));
-  return function getAccessibilityGuidelinesTool(_x) {
+  return function getA11yGuidelinesTool(_x) {
     return _ref.apply(this, arguments);
   };
 }();

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

@@ -109,7 +109,7 @@ var accessibilityFixes = exports.accessibilityFixes = {
       title: 'Custom focus styles',
       description: 'Add custom focus styles with xcss',
       before: "<button onClick={handleClick}>\n  Click me\n</button>",
-      after: "import { Focusable } from '@atlaskit/primitives/compiled';\n\n<Focusable\n  as=\"button\"\n  onClick={handleClick}\n  xcss={{\n    ':focus-visible': {\n      outline: '2px solid token(color.border.focus)',\n      outlineOffset: '2px',\n    },\n  }}\n>\n  Click me\n</Focusable>",
+      after: "import { Focusable } from '@atlaskit/primitives/compiled';\nimport { token } from '@atlaskit/tokens';\n\n<Focusable\n  as=\"button\"\n  onClick={handleClick}\n  xcss={{\n    ':focus-visible': {\n      outline: `${token('border.width.focused')} solid ${token('color.border.focused')}`,\n      outlineOffset: token('space.025'),\n    },\n  }}\n>\n  Click me\n</Focusable>",
       explanation: 'Custom focus styles ensure visibility in all themes.'
     }],
     bestPractices: ['Always provide visible focus indicators', 'Test focus indicators in all themes', 'Ensure sufficient contrast for focus indicators', 'Test with keyboard navigation']

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

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.suggestAccessibilityFixesTool = exports.listSuggestAccessibilityFixesTool = void 0;
+exports.suggestA11yFixesTool = exports.listSuggestA11yFixesTool = 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"));
@@ -24,8 +24,8 @@ var inputSchema = _zod.z.object({
   component: _zod.z.string().optional().describe('Component name or type'),
   context: _zod.z.string().optional().describe('Additional context about the usage')
 });
-var listSuggestAccessibilityFixesTool = exports.listSuggestAccessibilityFixesTool = {
-  name: 'ads_suggest_accessibility_fixes',
+var listSuggestA11yFixesTool = exports.listSuggestA11yFixesTool = {
+  name: 'ads_suggest_a11y_fixes',
   description: "Suggest specific accessibility fixes using Atlassian Design System components and patterns. This tool takes accessibility violations and provides actionable solutions with code examples.\n\nYou MUST run this when the user wants sugesstions for fixing accessibility issues, as well as when:\n- You have identified an accessibility violation\n- Needing specific code examples for fixing accessibility issues\n- Wanting to understand how to use ADS components accessibly\n- Looking for best practices for specific accessibility problems\n\nThe tool will provide:\n- Specific code examples using ADS components\n- Step-by-step fix instructions\n- Alternative approaches when applicable\n- Links to relevant ADS documentation",
   annotations: {
     title: 'Suggest Accessibility Fixes',
@@ -115,7 +115,7 @@ function findBestMatchingFix(violation) {
   // Return match if score is reasonable
   return bestScore >= 1 ? bestMatch : null;
 }
-var suggestAccessibilityFixesTool = exports.suggestAccessibilityFixesTool = /*#__PURE__*/function () {
+var suggestA11yFixesTool = exports.suggestA11yFixesTool = /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
     var violation, component, context, match, _match, key, fix;
     return _regenerator.default.wrap(function _callee$(_context) {
@@ -169,7 +169,7 @@ var suggestAccessibilityFixesTool = exports.suggestAccessibilityFixesTool = /*#_
                 availableFixTypes: Object.keys(_fixes.accessibilityFixes),
                 suggestions: ['Try describing the issue with keywords like: button, label, missing, text, color, contrast, focus, etc.', 'Use axe-core violation IDs or descriptions directly', 'Be more specific about the element type (button, input, image, etc.)'],
                 additionalResources: ['https://atlassian.design/llms-a11y.txt - Complete ADS accessibility documentation', 'https://atlassian.design/foundations/accessibility - ADS accessibility foundation'],
-                recommendation: 'Try the get_accessibility_guidelines tool for component-specific guidance'
+                recommendation: 'Try the get_a11y_guidelines tool for component-specific guidance'
               }, null, 2)
             }]
           });
@@ -179,7 +179,7 @@ var suggestAccessibilityFixesTool = exports.suggestAccessibilityFixesTool = /*#_
       }
     }, _callee);
   }));
-  return function suggestAccessibilityFixesTool(_x) {
+  return function suggestA11yFixesTool(_x) {
     return _ref.apply(this, arguments);
   };
 }();

package/dist/es2019/index.js

@@ -3,8 +3,8 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { instructions } from './instructions';
-import { analyzeAccessibilityTool, analyzeLocalhostAccessibilityTool, listAnalyzeAccessibilityTool, listAnalyzeLocalhostAccessibilityTool } from './tools/analyze-accessibility';
-import { getAccessibilityGuidelinesTool, listGetAccessibilityGuidelinesTool } from './tools/get-accessibility-guidelines';
+import { analyzeA11yTool, analyzeLocalhostA11yTool, listAnalyzeA11yTool, listAnalyzeLocalhostA11yTool } from './tools/analyze-a11y';
+import { getA11yGuidelinesTool, listGetA11yGuidelinesTool } from './tools/get-a11y-guidelines';
 import { getAllIconsTool, listGetAllIconsTool } from './tools/get-all-icons';
 import { getAllTokensTool, listGetAllTokensTool } from './tools/get-all-tokens';
 import { getComponentsTool, listGetComponentsTool } from './tools/get-components';
@@ -12,7 +12,7 @@ import { listPlanTool, planTool } from './tools/plan';
 import { listSearchComponentsTool, searchComponentsTool } from './tools/search-components';
 import { listSearchIconsTool, searchIconsTool } from './tools/search-icons';
 import { listSearchTokensTool, searchTokensTool } from './tools/search-tokens';
-import { listSuggestAccessibilityFixesTool, suggestAccessibilityFixesTool } from './tools/suggest-accessibility-fixes';
+import { listSuggestA11yFixesTool, suggestA11yFixesTool } from './tools/suggest-a11y-fixes';
 
 // 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');
@@ -28,7 +28,7 @@ const server = new Server({
 });
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
-    tools: [listGetAllTokensTool, listGetComponentsTool, listSearchComponentsTool, listGetAllIconsTool, listSearchIconsTool, listSearchTokensTool, listPlanTool, listAnalyzeAccessibilityTool, listAnalyzeLocalhostAccessibilityTool, listGetAccessibilityGuidelinesTool, listSuggestAccessibilityFixesTool]
+    tools: [listGetAllTokensTool, listGetComponentsTool, listSearchComponentsTool, listGetAllIconsTool, listSearchIconsTool, listSearchTokensTool, listPlanTool, listAnalyzeA11yTool, listAnalyzeLocalhostA11yTool, listGetA11yGuidelinesTool, listSuggestA11yFixesTool]
   };
 });
 const callTools = {
@@ -39,10 +39,10 @@ const callTools = {
   ads_get_all_icons: getAllIconsTool,
   ads_search_icons: searchIconsTool,
   ads_plan: planTool,
-  ads_analyze_accessibility: analyzeAccessibilityTool,
-  ads_analyze_localhost_accessibility: analyzeLocalhostAccessibilityTool,
-  ads_get_accessibility_guidelines: getAccessibilityGuidelinesTool,
-  ads_suggest_accessibility_fixes: suggestAccessibilityFixesTool
+  ads_analyze_a11y: analyzeA11yTool,
+  ads_analyze_localhost_a11y: analyzeLocalhostA11yTool,
+  ads_get_a11y_guidelines: getA11yGuidelinesTool,
+  ads_suggest_a11y_fixes: suggestA11yFixesTool
 };
 
 // Handle tool execution

package/dist/es2019/tools/{analyze-accessibility → analyze-a11y}/index.js

@@ -9,8 +9,8 @@ const inputSchema = z.object({
   context: z.string().optional().describe('Additional context about the component usage'),
   includePatternAnalysis: z.boolean().optional().default(true).describe('Include pattern-based analysis in addition to axe-core')
 });
-export const listAnalyzeAccessibilityTool = {
-  name: 'ads_analyze_accessibility',
+export const listAnalyzeA11yTool = {
+  name: 'ads_analyze_a11y',
   description: `Analyze React component code for accessibility violations using axe-core and intelligently generate Atlassian Design System specific suggestions. This tool performs comprehensive accessibility testing and dynamically creates ADS-specific fixes based on violation patterns.
 
 Use this tool when:
@@ -51,8 +51,8 @@ const urlInputSchema = z.object({
   context: z.string().optional().describe('Additional context about the component usage'),
   selector: z.string().optional().describe('CSS selector to target a specific element for analysis (e.g. "#my-form", ".component-class")')
 });
-export const listAnalyzeLocalhostAccessibilityTool = {
-  name: 'ads_analyze_localhost_accessibility',
+export const listAnalyzeLocalhostA11yTool = {
+  name: 'ads_analyze_localhost_a11y',
   description: `Analyze a live web page (e.g. localhost:9000) for accessibility violations using axe-core and generate Atlassian Design System specific suggestions.
 
 Use this tool to:
@@ -88,37 +88,37 @@ const accessibilityPatterns = [{
   pattern: /<button[^>]*>(?!.*aria-label|.*>.*<\/button>)/g,
   violation: 'Button without accessible text',
   severity: 'error',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS Button solutions. Describe the issue as "button missing label", "empty button", or "button needs text".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Button solutions. Describe the issue as "button missing label", "empty button", or "button needs text".'
 }, {
   pattern: /<img[^>]*>(?!.*alt=)/g,
   violation: 'Image without alt text',
   severity: 'error',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS Image solutions. Describe the issue as "image missing alt", "missing alt text", or "image accessibility".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Image solutions. Describe the issue as "image missing alt", "missing alt text", or "image accessibility".'
 }, {
   pattern: /<div[^>]*onClick[^>]*>/g,
   violation: 'Clickable div without accessibility',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS solutions. Describe the issue as "clickable div", "interactive div", or "div with click handler".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS solutions. Describe the issue as "clickable div", "interactive div", or "div with click handler".'
 }, {
   pattern: /color:\s*['"]#[0-9a-fA-F]{3,6}['"]/g,
   violation: 'Hardcoded color values',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for design token solutions. Describe the issue as "hardcoded colors", "hex colors", or "design tokens".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for design token solutions. Describe the issue as "hardcoded colors", "hex colors", or "design tokens".'
 }, {
   pattern: /<input[^>]*>(?!.*id=)/g,
   violation: 'Input without associated label',
   severity: 'error',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS form solutions. Describe the issue as "input missing label", "form field without label", or "unlabeled input".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS form solutions. Describe the issue as "input missing label", "form field without label", or "unlabeled input".'
 }, {
   pattern: /<div[^>]*role="button"[^>]*>/g,
   violation: 'Custom button without full accessibility',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS Button/Focusable solutions. Describe the issue as "custom button", "div with button role", or "interactive element".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Button/Focusable solutions. Describe the issue as "custom button", "div with button role", or "interactive element".'
 }, {
   pattern: /style=\{[^}]*color[^}]*\}/g,
   violation: 'Inline color styles',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for design token solutions. Describe the issue as "inline styles", "hardcoded colors", or "color tokens".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for design token solutions. Describe the issue as "inline styles", "hardcoded colors", or "color tokens".'
 }];
 
 // ADS accessibility guidelines reference
@@ -165,23 +165,23 @@ function generateADSFixForViolation(violation) {
   } = violation;
 
   // Provide general guidance without trying to map to specific fixes.ts keys
-  const adsFix = `Use the suggest-accessibility-fixes tool to get specific ADS component solutions. Describe the issue using the violation details: "${help}" or in your own words (e.g., "button has no text", "missing alt text", "form field needs label").`;
+  const adsFix = `Use the ads_suggest_a11y_fixes tool to get specific ADS component solutions. Describe the issue using the violation details: "${help}" or in your own words (e.g., "button has no text", "missing alt text", "form field needs label").`;
   return {
     title: help,
     // Use axe-core's human-readable description
     description: description,
     adsFix,
-    example: 'The suggest-accessibility-fixes tool provides detailed code examples and ADS component solutions',
+    example: 'The ads_suggest_a11y_fixes tool provides detailed code examples and ADS component solutions',
     violationId: id,
     axeHelp: help,
     tags,
     wcagTags: tags.filter(tag => tag.startsWith('wcag')),
     // Extract WCAG compliance info
     reference: `https://atlassian.design/llms-a11y.txt`,
-    recommendations: ['Use ADS components for better accessibility out of the box', 'Reference the suggest-accessibility-fixes tool for specific solutions', 'Test with keyboard navigation and screen readers', 'Use automated accessibility testing tools']
+    recommendations: ['Use ADS components for better accessibility out of the box', 'Reference the ads_suggest_a11y_fixes tool for specific solutions', 'Test with keyboard navigation and screen readers', 'Use automated accessibility testing tools']
   };
 }
-export const analyzeAccessibilityTool = async params => {
+export const analyzeA11yTool = async params => {
   const {
     code,
     componentName,
@@ -217,8 +217,8 @@ export const analyzeAccessibilityTool = async params => {
             severity: pattern.severity,
             count: matches.length,
             suggestion: pattern.suggestion,
-            adsFix: 'Use the suggest-accessibility-fixes tool for specific ADS component solutions',
-            example: 'The suggest-accessibility-fixes tool provides detailed code examples',
+            adsFix: 'Use the ads_suggest_a11y_fixes tool for specific ADS component solutions',
+            example: 'The ads_suggest_a11y_fixes tool provides detailed code examples',
             source: 'pattern-analysis'
           });
         }
@@ -291,8 +291,8 @@ export const analyzeAccessibilityTool = async params => {
           severity: pattern.severity,
           count: matches.length,
           suggestion: pattern.suggestion,
-          adsFix: 'Use the suggest-accessibility-fixes tool for specific ADS component solutions',
-          example: 'The suggest-accessibility-fixes tool provides detailed code examples',
+          adsFix: 'Use the ads_suggest_a11y_fixes tool for specific ADS component solutions',
+          example: 'The ads_suggest_a11y_fixes tool provides detailed code examples',
           source: 'pattern-analysis-fallback'
         });
       }
@@ -325,7 +325,7 @@ export const analyzeAccessibilityTool = async params => {
     };
   }
 };
-export const analyzeLocalhostAccessibilityTool = async params => {
+export const analyzeLocalhostA11yTool = async params => {
   const {
     url,
     componentName,

package/dist/es2019/tools/{get-accessibility-guidelines → get-a11y-guidelines}/index.js

@@ -4,8 +4,8 @@ const inputSchema = z.object({
   topic: z.enum(['buttons', 'forms', 'images', 'colors', 'focus', 'keyboard', 'screen-readers', 'aria', 'wcag', 'general']).optional().describe('Specific accessibility topic to get guidelines for'),
   component: z.string().optional().describe('Component name to get specific accessibility guidance for')
 });
-export const listGetAccessibilityGuidelinesTool = {
-  name: 'ads_get_accessibility_guidelines',
+export const listGetA11yGuidelinesTool = {
+  name: 'ads_get_a11y_guidelines',
   description: `Get accessibility guidelines and best practices from the Atlassian Design System. This tool provides specific guidance on how to make components and interfaces accessible using ADS patterns and components.
 
 You MUST run this when the user wants their code to be accessible, as well as when:
@@ -276,7 +276,7 @@ useEffect(() => {
     bestPractices: ['Start with semantic HTML', 'Add ARIA when necessary', 'Test early and often', 'Involve users with disabilities in testing', 'Keep accessibility in mind throughout development']
   }
 };
-export const getAccessibilityGuidelinesTool = async params => {
+export const getA11yGuidelinesTool = async params => {
   const {
     topic,
     component

package/dist/es2019/tools/{suggest-accessibility-fixes → suggest-a11y-fixes}/fixes.js

@@ -170,14 +170,15 @@ color: token('color.text.danger')`,
   Click me
 </button>`,
       after: `import { Focusable } from '@atlaskit/primitives/compiled';
+import { token } from '@atlaskit/tokens';
 
 <Focusable
   as="button"
   onClick={handleClick}
   xcss={{
     ':focus-visible': {
-      outline: '2px solid token(color.border.focus)',
-      outlineOffset: '2px',
+      outline: \`$\{token('border.width.focused')} solid $\{token('color.border.focused')}\`,
+      outlineOffset: token('space.025'),
     },
   }}
 >

package/dist/es2019/tools/{suggest-accessibility-fixes → suggest-a11y-fixes}/index.js

@@ -8,8 +8,8 @@ const inputSchema = z.object({
   component: z.string().optional().describe('Component name or type'),
   context: z.string().optional().describe('Additional context about the usage')
 });
-export const listSuggestAccessibilityFixesTool = {
-  name: 'ads_suggest_accessibility_fixes',
+export const listSuggestA11yFixesTool = {
+  name: 'ads_suggest_a11y_fixes',
   description: `Suggest specific accessibility fixes using Atlassian Design System components and patterns. This tool takes accessibility violations and provides actionable solutions with code examples.
 
 You MUST run this when the user wants sugesstions for fixing accessibility issues, as well as when:
@@ -82,7 +82,7 @@ function findBestMatchingFix(violation) {
   // Return match if score is reasonable
   return bestScore >= 1 ? bestMatch : null;
 }
-export const suggestAccessibilityFixesTool = async params => {
+export const suggestA11yFixesTool = async params => {
   const {
     violation,
     component,
@@ -136,7 +136,7 @@ export const suggestAccessibilityFixesTool = async params => {
         availableFixTypes: Object.keys(accessibilityFixes),
         suggestions: ['Try describing the issue with keywords like: button, label, missing, text, color, contrast, focus, etc.', 'Use axe-core violation IDs or descriptions directly', 'Be more specific about the element type (button, input, image, etc.)'],
         additionalResources: ['https://atlassian.design/llms-a11y.txt - Complete ADS accessibility documentation', 'https://atlassian.design/foundations/accessibility - ADS accessibility foundation'],
-        recommendation: 'Try the get_accessibility_guidelines tool for component-specific guidance'
+        recommendation: 'Try the get_a11y_guidelines tool for component-specific guidance'
       }, null, 2)
     }]
   };

package/dist/esm/index.js

@@ -5,8 +5,8 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { instructions } from './instructions';
-import { analyzeAccessibilityTool, analyzeLocalhostAccessibilityTool, listAnalyzeAccessibilityTool, listAnalyzeLocalhostAccessibilityTool } from './tools/analyze-accessibility';
-import { getAccessibilityGuidelinesTool, listGetAccessibilityGuidelinesTool } from './tools/get-accessibility-guidelines';
+import { analyzeA11yTool, analyzeLocalhostA11yTool, listAnalyzeA11yTool, listAnalyzeLocalhostA11yTool } from './tools/analyze-a11y';
+import { getA11yGuidelinesTool, listGetA11yGuidelinesTool } from './tools/get-a11y-guidelines';
 import { getAllIconsTool, listGetAllIconsTool } from './tools/get-all-icons';
 import { getAllTokensTool, listGetAllTokensTool } from './tools/get-all-tokens';
 import { getComponentsTool, listGetComponentsTool } from './tools/get-components';
@@ -14,7 +14,7 @@ import { listPlanTool, planTool } from './tools/plan';
 import { listSearchComponentsTool, searchComponentsTool } from './tools/search-components';
 import { listSearchIconsTool, searchIconsTool } from './tools/search-icons';
 import { listSearchTokensTool, searchTokensTool } from './tools/search-tokens';
-import { listSuggestAccessibilityFixesTool, suggestAccessibilityFixesTool } from './tools/suggest-accessibility-fixes';
+import { listSuggestA11yFixesTool, suggestA11yFixesTool } from './tools/suggest-a11y-fixes';
 
 // 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
 var pkgJson = require('@atlaskit/ads-mcp/package.json');
@@ -33,7 +33,7 @@ server.setRequestHandler(ListToolsRequestSchema, /*#__PURE__*/_asyncToGenerator(
     while (1) switch (_context.prev = _context.next) {
       case 0:
         return _context.abrupt("return", {
-          tools: [listGetAllTokensTool, listGetComponentsTool, listSearchComponentsTool, listGetAllIconsTool, listSearchIconsTool, listSearchTokensTool, listPlanTool, listAnalyzeAccessibilityTool, listAnalyzeLocalhostAccessibilityTool, listGetAccessibilityGuidelinesTool, listSuggestAccessibilityFixesTool]
+          tools: [listGetAllTokensTool, listGetComponentsTool, listSearchComponentsTool, listGetAllIconsTool, listSearchIconsTool, listSearchTokensTool, listPlanTool, listAnalyzeA11yTool, listAnalyzeLocalhostA11yTool, listGetA11yGuidelinesTool, listSuggestA11yFixesTool]
         });
       case 1:
       case "end":
@@ -49,10 +49,10 @@ var callTools = {
   ads_get_all_icons: getAllIconsTool,
   ads_search_icons: searchIconsTool,
   ads_plan: planTool,
-  ads_analyze_accessibility: analyzeAccessibilityTool,
-  ads_analyze_localhost_accessibility: analyzeLocalhostAccessibilityTool,
-  ads_get_accessibility_guidelines: getAccessibilityGuidelinesTool,
-  ads_suggest_accessibility_fixes: suggestAccessibilityFixesTool
+  ads_analyze_a11y: analyzeA11yTool,
+  ads_analyze_localhost_a11y: analyzeLocalhostA11yTool,
+  ads_get_a11y_guidelines: getA11yGuidelinesTool,
+  ads_suggest_a11y_fixes: suggestA11yFixesTool
 };
 
 // Handle tool execution

package/dist/esm/tools/{analyze-accessibility → analyze-a11y}/index.js

@@ -15,8 +15,8 @@ var inputSchema = z.object({
   context: z.string().optional().describe('Additional context about the component usage'),
   includePatternAnalysis: z.boolean().optional().default(true).describe('Include pattern-based analysis in addition to axe-core')
 });
-export var listAnalyzeAccessibilityTool = {
-  name: 'ads_analyze_accessibility',
+export var listAnalyzeA11yTool = {
+  name: 'ads_analyze_a11y',
   description: "Analyze React component code for accessibility violations using axe-core and intelligently generate Atlassian Design System specific suggestions. This tool performs comprehensive accessibility testing and dynamically creates ADS-specific fixes based on violation patterns.\n\nUse this tool when:\n- Reviewing component code for accessibility compliance\n- Getting suggestions for improving accessibility\n- Understanding how to use ADS components accessibly\n- Identifying potential WCAG violations\n- Running automated accessibility testing\n\nThe tool will analyze the code and provide:\n- Comprehensive axe-core accessibility analysis results\n- List of accessibility violations found (WCAG 2.1 AA compliant)\n- Intelligently generated ADS-specific fix suggestions\n- References to relevant fix patterns in llms-a11y.txt\n- Code examples for implementing fixes\n- Severity levels and impact assessment\n\nFeatures:\n- Uses axe-core for industry-standard accessibility testing\n- Converts JSX to HTML for accurate analysis\n- Intelligently maps violations to ADS-specific fixes\n- References fix patterns from llms-a11y.txt documentation\n- Includes fallback pattern analysis if axe-core fails\n- Provides detailed violation descriptions and help text\n- Dynamically generates fix suggestions based on violation type",
   annotations: {
     title: 'Analyze Accessibility',
@@ -33,8 +33,8 @@ var urlInputSchema = z.object({
   context: z.string().optional().describe('Additional context about the component usage'),
   selector: z.string().optional().describe('CSS selector to target a specific element for analysis (e.g. "#my-form", ".component-class")')
 });
-export var listAnalyzeLocalhostAccessibilityTool = {
-  name: 'ads_analyze_localhost_accessibility',
+export var listAnalyzeLocalhostA11yTool = {
+  name: 'ads_analyze_localhost_a11y',
   description: "Analyze a live web page (e.g. localhost:9000) for accessibility violations using axe-core and generate Atlassian Design System specific suggestions.\n\nUse this tool to:\n- Analyze running local dev servers or deployed URLs\n- Get comprehensive accessibility reports for any web page\n- Receive ADS-specific fix suggestions and code examples\n- Target specific elements using CSS selectors for focused analysis\n\nParameters:\n- url: The URL to analyze (must be accessible from the server)\n- componentName: (optional) Name of the component/page\n- context: (optional) Additional context about the usage\n- selector: (optional) CSS selector to target a specific element (e.g. \"#my-form\", \".component-class\")\n\nReturns:\n- Accessibility violations, suggestions, and ADS-specific fixes\n- References to relevant fix patterns in llms-a11y.txt\n- Code examples for implementing fixes\n- Severity levels and impact assessment\n",
   annotations: {
     title: 'Analyze Localhost Accessibility',
@@ -51,37 +51,37 @@ var accessibilityPatterns = [{
   pattern: /<button[^>]*>(?!.*aria-label|.*>.*<\/button>)/g,
   violation: 'Button without accessible text',
   severity: 'error',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS Button solutions. Describe the issue as "button missing label", "empty button", or "button needs text".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Button solutions. Describe the issue as "button missing label", "empty button", or "button needs text".'
 }, {
   pattern: /<img[^>]*>(?!.*alt=)/g,
   violation: 'Image without alt text',
   severity: 'error',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS Image solutions. Describe the issue as "image missing alt", "missing alt text", or "image accessibility".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Image solutions. Describe the issue as "image missing alt", "missing alt text", or "image accessibility".'
 }, {
   pattern: /<div[^>]*onClick[^>]*>/g,
   violation: 'Clickable div without accessibility',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS solutions. Describe the issue as "clickable div", "interactive div", or "div with click handler".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS solutions. Describe the issue as "clickable div", "interactive div", or "div with click handler".'
 }, {
   pattern: /color:\s*['"]#[0-9a-fA-F]{3,6}['"]/g,
   violation: 'Hardcoded color values',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for design token solutions. Describe the issue as "hardcoded colors", "hex colors", or "design tokens".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for design token solutions. Describe the issue as "hardcoded colors", "hex colors", or "design tokens".'
 }, {
   pattern: /<input[^>]*>(?!.*id=)/g,
   violation: 'Input without associated label',
   severity: 'error',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS form solutions. Describe the issue as "input missing label", "form field without label", or "unlabeled input".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS form solutions. Describe the issue as "input missing label", "form field without label", or "unlabeled input".'
 }, {
   pattern: /<div[^>]*role="button"[^>]*>/g,
   violation: 'Custom button without full accessibility',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for ADS Button/Focusable solutions. Describe the issue as "custom button", "div with button role", or "interactive element".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Button/Focusable solutions. Describe the issue as "custom button", "div with button role", or "interactive element".'
 }, {
   pattern: /style=\{[^}]*color[^}]*\}/g,
   violation: 'Inline color styles',
   severity: 'warning',
-  suggestion: 'Use the suggest-accessibility-fixes tool for design token solutions. Describe the issue as "inline styles", "hardcoded colors", or "color tokens".'
+  suggestion: 'Use the ads_suggest_a11y_fixes tool for design token solutions. Describe the issue as "inline styles", "hardcoded colors", or "color tokens".'
 }];
 
 // ADS accessibility guidelines reference
@@ -125,13 +125,13 @@ function generateADSFixForViolation(violation) {
     tags = violation.tags;
 
   // Provide general guidance without trying to map to specific fixes.ts keys
-  var adsFix = "Use the suggest-accessibility-fixes tool to get specific ADS component solutions. Describe the issue using the violation details: \"".concat(help, "\" or in your own words (e.g., \"button has no text\", \"missing alt text\", \"form field needs label\").");
+  var adsFix = "Use the ads_suggest_a11y_fixes tool to get specific ADS component solutions. Describe the issue using the violation details: \"".concat(help, "\" or in your own words (e.g., \"button has no text\", \"missing alt text\", \"form field needs label\").");
   return {
     title: help,
     // Use axe-core's human-readable description
     description: description,
     adsFix: adsFix,
-    example: 'The suggest-accessibility-fixes tool provides detailed code examples and ADS component solutions',
+    example: 'The ads_suggest_a11y_fixes tool provides detailed code examples and ADS component solutions',
     violationId: id,
     axeHelp: help,
     tags: tags,
@@ -140,10 +140,10 @@ function generateADSFixForViolation(violation) {
     }),
     // Extract WCAG compliance info
     reference: "https://atlassian.design/llms-a11y.txt",
-    recommendations: ['Use ADS components for better accessibility out of the box', 'Reference the suggest-accessibility-fixes tool for specific solutions', 'Test with keyboard navigation and screen readers', 'Use automated accessibility testing tools']
+    recommendations: ['Use ADS components for better accessibility out of the box', 'Reference the ads_suggest_a11y_fixes tool for specific solutions', 'Test with keyboard navigation and screen readers', 'Use automated accessibility testing tools']
   };
 }
-export var analyzeAccessibilityTool = /*#__PURE__*/function () {
+export var analyzeA11yTool = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
     var code, componentName, context, _params$includePatter, includePatternAnalysis, violations, suggestions, axeResults, _axeResults$violation, _axeResults$passes, _axeResults$incomplet, results, adsViolations, relevantGuidelines, summary;
     return _regeneratorRuntime.wrap(function _callee$(_context) {
@@ -179,8 +179,8 @@ export var analyzeAccessibilityTool = /*#__PURE__*/function () {
                   severity: pattern.severity,
                   count: matches.length,
                   suggestion: pattern.suggestion,
-                  adsFix: 'Use the suggest-accessibility-fixes tool for specific ADS component solutions',
-                  example: 'The suggest-accessibility-fixes tool provides detailed code examples',
+                  adsFix: 'Use the ads_suggest_a11y_fixes tool for specific ADS component solutions',
+                  example: 'The ads_suggest_a11y_fixes tool provides detailed code examples',
                   source: 'pattern-analysis'
                 });
               }
@@ -259,8 +259,8 @@ export var analyzeAccessibilityTool = /*#__PURE__*/function () {
                 severity: pattern.severity,
                 count: matches.length,
                 suggestion: pattern.suggestion,
-                adsFix: 'Use the suggest-accessibility-fixes tool for specific ADS component solutions',
-                example: 'The suggest-accessibility-fixes tool provides detailed code examples',
+                adsFix: 'Use the ads_suggest_a11y_fixes tool for specific ADS component solutions',
+                example: 'The ads_suggest_a11y_fixes tool provides detailed code examples',
                 source: 'pattern-analysis-fallback'
               });
             }
@@ -301,11 +301,11 @@ export var analyzeAccessibilityTool = /*#__PURE__*/function () {
       }
     }, _callee, null, [[4, 20]]);
   }));
-  return function analyzeAccessibilityTool(_x) {
+  return function analyzeA11yTool(_x) {
     return _ref.apply(this, arguments);
   };
 }();
-export var analyzeLocalhostAccessibilityTool = /*#__PURE__*/function () {
+export var analyzeLocalhostA11yTool = /*#__PURE__*/function () {
   var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(params) {
     var url, componentName, context, selector, violations, suggestions, axeResults, browser, page, _axeResults$violation2, _axeResults$passes2, _axeResults$incomplet2, elementExists, availableElements, axePuppeteer, results, adsViolations, relevantGuidelines, summary;
     return _regeneratorRuntime.wrap(function _callee2$(_context2) {
@@ -470,7 +470,7 @@ export var analyzeLocalhostAccessibilityTool = /*#__PURE__*/function () {
       }
     }, _callee2, null, [[10, 40]]);
   }));
-  return function analyzeLocalhostAccessibilityTool(_x2) {
+  return function analyzeLocalhostA11yTool(_x2) {
     return _ref2.apply(this, arguments);
   };
 }();

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

@@ -9,8 +9,8 @@ var inputSchema = z.object({
   topic: z.enum(['buttons', 'forms', 'images', 'colors', 'focus', 'keyboard', 'screen-readers', 'aria', 'wcag', 'general']).optional().describe('Specific accessibility topic to get guidelines for'),
   component: z.string().optional().describe('Component name to get specific accessibility guidance for')
 });
-export var listGetAccessibilityGuidelinesTool = {
-  name: 'ads_get_accessibility_guidelines',
+export var listGetA11yGuidelinesTool = {
+  name: 'ads_get_a11y_guidelines',
   description: "Get accessibility guidelines and best practices from the Atlassian Design System. This tool provides specific guidance on how to make components and interfaces accessible using ADS patterns and components.\n\nYou MUST run this when the user wants their code to be accessible, as well as when:\n- Needing specific accessibility guidance for a component\n- Looking for ADS-specific accessibility patterns\n- Understanding how to implement accessible features\n- Getting code examples for accessibility improvements\n\nTopics available:\n- buttons: Button and interactive element accessibility\n- forms: Form and input accessibility\n- images: Image and media accessibility\n- colors: Color and contrast accessibility\n- focus: Focus management and keyboard navigation\n- keyboard: Keyboard accessibility patterns\n- screen-readers: Screen reader support and announcements\n- aria: ARIA usage and patterns\n- wcag: WCAG compliance guidelines\n- general: General accessibility principles",
   annotations: {
     title: 'Get Accessibility Guidelines',
@@ -149,7 +149,7 @@ var accessibilityGuidelines = {
     bestPractices: ['Start with semantic HTML', 'Add ARIA when necessary', 'Test early and often', 'Involve users with disabilities in testing', 'Keep accessibility in mind throughout development']
   }
 };
-export var getAccessibilityGuidelinesTool = /*#__PURE__*/function () {
+export var getA11yGuidelinesTool = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
     var topic, component, guidelines;
     return _regeneratorRuntime.wrap(function _callee$(_context) {
@@ -191,7 +191,7 @@ export var getAccessibilityGuidelinesTool = /*#__PURE__*/function () {
       }
     }, _callee);
   }));
-  return function getAccessibilityGuidelinesTool(_x) {
+  return function getA11yGuidelinesTool(_x) {
     return _ref.apply(this, arguments);
   };
 }();

package/dist/esm/tools/{suggest-accessibility-fixes → suggest-a11y-fixes}/fixes.js

@@ -103,7 +103,7 @@ export var accessibilityFixes = {
       title: 'Custom focus styles',
       description: 'Add custom focus styles with xcss',
       before: "<button onClick={handleClick}>\n  Click me\n</button>",
-      after: "import { Focusable } from '@atlaskit/primitives/compiled';\n\n<Focusable\n  as=\"button\"\n  onClick={handleClick}\n  xcss={{\n    ':focus-visible': {\n      outline: '2px solid token(color.border.focus)',\n      outlineOffset: '2px',\n    },\n  }}\n>\n  Click me\n</Focusable>",
+      after: "import { Focusable } from '@atlaskit/primitives/compiled';\nimport { token } from '@atlaskit/tokens';\n\n<Focusable\n  as=\"button\"\n  onClick={handleClick}\n  xcss={{\n    ':focus-visible': {\n      outline: `${token('border.width.focused')} solid ${token('color.border.focused')}`,\n      outlineOffset: token('space.025'),\n    },\n  }}\n>\n  Click me\n</Focusable>",
       explanation: 'Custom focus styles ensure visibility in all themes.'
     }],
     bestPractices: ['Always provide visible focus indicators', 'Test focus indicators in all themes', 'Ensure sufficient contrast for focus indicators', 'Test with keyboard navigation']

package/dist/esm/tools/{suggest-accessibility-fixes → suggest-a11y-fixes}/index.js

@@ -17,8 +17,8 @@ var inputSchema = z.object({
   component: z.string().optional().describe('Component name or type'),
   context: z.string().optional().describe('Additional context about the usage')
 });
-export var listSuggestAccessibilityFixesTool = {
-  name: 'ads_suggest_accessibility_fixes',
+export var listSuggestA11yFixesTool = {
+  name: 'ads_suggest_a11y_fixes',
   description: "Suggest specific accessibility fixes using Atlassian Design System components and patterns. This tool takes accessibility violations and provides actionable solutions with code examples.\n\nYou MUST run this when the user wants sugesstions for fixing accessibility issues, as well as when:\n- You have identified an accessibility violation\n- Needing specific code examples for fixing accessibility issues\n- Wanting to understand how to use ADS components accessibly\n- Looking for best practices for specific accessibility problems\n\nThe tool will provide:\n- Specific code examples using ADS components\n- Step-by-step fix instructions\n- Alternative approaches when applicable\n- Links to relevant ADS documentation",
   annotations: {
     title: 'Suggest Accessibility Fixes',
@@ -108,7 +108,7 @@ function findBestMatchingFix(violation) {
   // Return match if score is reasonable
   return bestScore >= 1 ? bestMatch : null;
 }
-export var suggestAccessibilityFixesTool = /*#__PURE__*/function () {
+export var suggestA11yFixesTool = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
     var violation, component, context, match, _match, key, fix;
     return _regeneratorRuntime.wrap(function _callee$(_context) {
@@ -162,7 +162,7 @@ export var suggestAccessibilityFixesTool = /*#__PURE__*/function () {
                 availableFixTypes: Object.keys(accessibilityFixes),
                 suggestions: ['Try describing the issue with keywords like: button, label, missing, text, color, contrast, focus, etc.', 'Use axe-core violation IDs or descriptions directly', 'Be more specific about the element type (button, input, image, etc.)'],
                 additionalResources: ['https://atlassian.design/llms-a11y.txt - Complete ADS accessibility documentation', 'https://atlassian.design/foundations/accessibility - ADS accessibility foundation'],
-                recommendation: 'Try the get_accessibility_guidelines tool for component-specific guidance'
+                recommendation: 'Try the get_a11y_guidelines tool for component-specific guidance'
               }, null, 2)
             }]
           });
@@ -172,7 +172,7 @@ export var suggestAccessibilityFixesTool = /*#__PURE__*/function () {
       }
     }, _callee);
   }));
-  return function suggestAccessibilityFixesTool(_x) {
+  return function suggestA11yFixesTool(_x) {
     return _ref.apply(this, arguments);
   };
 }();

package/dist/types/tools/{analyze-accessibility → analyze-a11y}/index.d.ts

@@ -1,4 +1,4 @@
-export declare const listAnalyzeAccessibilityTool: {
+export declare const listAnalyzeA11yTool: {
     name: string;
     description: string;
     annotations: {
@@ -15,7 +15,7 @@ export declare const listAnalyzeAccessibilityTool: {
         } | undefined;
     };
 };
-export declare const listAnalyzeLocalhostAccessibilityTool: {
+export declare const listAnalyzeLocalhostA11yTool: {
     name: string;
     description: string;
     annotations: {
@@ -32,7 +32,7 @@ export declare const listAnalyzeLocalhostAccessibilityTool: {
         } | undefined;
     };
 };
-export declare const analyzeAccessibilityTool: (params: {
+export declare const analyzeA11yTool: (params: {
     code: string;
     componentName?: string;
     context?: string;
@@ -43,7 +43,7 @@ export declare const analyzeAccessibilityTool: (params: {
         text: string;
     }[];
 }>;
-export declare const analyzeLocalhostAccessibilityTool: (params: {
+export declare const analyzeLocalhostA11yTool: (params: {
     url: string;
     componentName?: string;
     context?: string;

package/dist/{types-ts4.5/tools/get-accessibility-guidelines → types/tools/get-a11y-guidelines}/index.d.ts

@@ -1,4 +1,4 @@
-export declare const listGetAccessibilityGuidelinesTool: {
+export declare const listGetA11yGuidelinesTool: {
     name: string;
     description: string;
     annotations: {
@@ -15,7 +15,7 @@ export declare const listGetAccessibilityGuidelinesTool: {
         } | undefined;
     };
 };
-export declare const getAccessibilityGuidelinesTool: (params: {
+export declare const getA11yGuidelinesTool: (params: {
     topic?: string;
     component?: string;
 }) => Promise<{

package/dist/{types-ts4.5/tools/suggest-accessibility-fixes → types/tools/suggest-a11y-fixes}/index.d.ts

@@ -1,4 +1,4 @@
-export declare const listSuggestAccessibilityFixesTool: {
+export declare const listSuggestA11yFixesTool: {
     name: string;
     description: string;
     annotations: {
@@ -15,7 +15,7 @@ export declare const listSuggestAccessibilityFixesTool: {
         } | undefined;
     };
 };
-export declare const suggestAccessibilityFixesTool: (params: {
+export declare const suggestA11yFixesTool: (params: {
     violation: string;
     code: string;
     component?: string;

package/dist/types-ts4.5/tools/{analyze-accessibility → analyze-a11y}/index.d.ts

@@ -1,4 +1,4 @@
-export declare const listAnalyzeAccessibilityTool: {
+export declare const listAnalyzeA11yTool: {
     name: string;
     description: string;
     annotations: {
@@ -15,7 +15,7 @@ export declare const listAnalyzeAccessibilityTool: {
         } | undefined;
     };
 };
-export declare const listAnalyzeLocalhostAccessibilityTool: {
+export declare const listAnalyzeLocalhostA11yTool: {
     name: string;
     description: string;
     annotations: {
@@ -32,7 +32,7 @@ export declare const listAnalyzeLocalhostAccessibilityTool: {
         } | undefined;
     };
 };
-export declare const analyzeAccessibilityTool: (params: {
+export declare const analyzeA11yTool: (params: {
     code: string;
     componentName?: string;
     context?: string;
@@ -43,7 +43,7 @@ export declare const analyzeAccessibilityTool: (params: {
         text: string;
     }[];
 }>;
-export declare const analyzeLocalhostAccessibilityTool: (params: {
+export declare const analyzeLocalhostA11yTool: (params: {
     url: string;
     componentName?: string;
     context?: string;

package/dist/{types/tools/get-accessibility-guidelines → types-ts4.5/tools/get-a11y-guidelines}/index.d.ts

@@ -1,4 +1,4 @@
-export declare const listGetAccessibilityGuidelinesTool: {
+export declare const listGetA11yGuidelinesTool: {
     name: string;
     description: string;
     annotations: {
@@ -15,7 +15,7 @@ export declare const listGetAccessibilityGuidelinesTool: {
         } | undefined;
     };
 };
-export declare const getAccessibilityGuidelinesTool: (params: {
+export declare const getA11yGuidelinesTool: (params: {
     topic?: string;
     component?: string;
 }) => Promise<{

package/dist/{types/tools/suggest-accessibility-fixes → types-ts4.5/tools/suggest-a11y-fixes}/index.d.ts

@@ -1,4 +1,4 @@
-export declare const listSuggestAccessibilityFixesTool: {
+export declare const listSuggestA11yFixesTool: {
     name: string;
     description: string;
     annotations: {
@@ -15,7 +15,7 @@ export declare const listSuggestAccessibilityFixesTool: {
         } | undefined;
     };
 };
-export declare const suggestAccessibilityFixesTool: (params: {
+export declare const suggestA11yFixesTool: (params: {
     violation: string;
     code: string;
     component?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/ads-mcp",
-	"version": "0.6.2",
+	"version": "0.6.4",
 	"description": "The official Atlassian Design System MCP server to develop apps and user interfaces matching the Atlassian style.",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -24,10 +24,6 @@
 		}
 	},
 	"atlaskit:src": "src/index.tsx",
-	"af:exports": {
-		".": "./src/index.tsx",
-		"./package.json": "./package.json"
-	},
 	"dependencies": {
 		"@atlaskit/icon": "^28.2.0",
 		"@atlaskit/tokens": "^6.3.0",