@atlaskit/ads-mcp 0.8.6 → 0.9.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @atlaskit/ads-mcp
 
+## 0.9.1
+
+### Patch Changes
+
+- [`286a209277502`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/286a209277502) -
+  update inputSchema type in getToolRegistry
+
+## 0.9.0
+
+### Minor Changes
+
+- [`55344b6c664f0`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/55344b6c664f0) -
+  Combine "Get All Tokens" and "Search Tokens" tools and convert their output format to Markdown.
+
+### Patch Changes
+
+- [`ec7caf4e1130d`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/ec7caf4e1130d) -
+  Remove mentions of `@atlaskit/announcer` in accessibility guidance.
+
 ## 0.8.6
 
 ### Patch Changes

package/dist/cjs/index.js

@@ -4,13 +4,14 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.toolRegistry = void 0;
+exports.getToolRegistry = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _index = require("@modelcontextprotocol/sdk/server/index.js");
 var _stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 var _types = require("@modelcontextprotocol/sdk/types.js");
+var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 var _analytics = require("./helpers/analytics");
 var _validation = require("./helpers/validation");
 var _instructions = require("./instructions");
@@ -19,6 +20,7 @@ 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");
+var _getTokens = require("./tools/get-tokens");
 var _plan = require("./tools/plan");
 var _suggestA11yFixes = require("./tools/suggest-a11y-fixes");
 /* eslint-disable no-console, import/extensions */
@@ -57,45 +59,60 @@ var generateLogger = function generateLogger(level) {
     }
   };
 };
-var toolRegistry = exports.toolRegistry = (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _analyzeA11y.listAnalyzeA11yTool.name, {
-  handler: _analyzeA11y.analyzeA11yTool,
-  inputSchema: _analyzeA11y.analyzeA11yInputSchema,
-  tool: _analyzeA11y.listAnalyzeA11yTool
-}), _analyzeA11y.listAnalyzeLocalhostA11yTool.name, {
-  handler: _analyzeA11y.analyzeLocalhostA11yTool,
-  inputSchema: _analyzeA11y.analyzeA11yLocalhostInputSchema,
-  tool: _analyzeA11y.listAnalyzeLocalhostA11yTool
-}), _getA11yGuidelines.listGetA11yGuidelinesTool.name, {
-  handler: _getA11yGuidelines.getA11yGuidelinesTool,
-  inputSchema: _getA11yGuidelines.getA11yGuidelinesInputSchema,
-  tool: _getA11yGuidelines.listGetA11yGuidelinesTool
-}), _getAllIcons.listGetAllIconsTool.name, {
-  handler: _getAllIcons.getAllIconsTool,
-  inputSchema: null,
-  tool: _getAllIcons.listGetAllIconsTool
-}), _getAllTokens.listGetAllTokensTool.name, {
-  handler: _getAllTokens.getAllTokensTool,
-  inputSchema: null,
-  tool: _getAllTokens.listGetAllTokensTool
-}), _getComponents.listGetComponentsTool.name, {
-  handler: _getComponents.getComponentsTool,
-  inputSchema: null,
-  tool: _getComponents.listGetComponentsTool
-}), _plan.listPlanTool.name, {
-  handler: _plan.planTool,
-  inputSchema: _plan.planInputSchema,
-  tool: _plan.listPlanTool
-}), _suggestA11yFixes.listSuggestA11yFixesTool.name, {
-  handler: _suggestA11yFixes.suggestA11yFixesTool,
-  inputSchema: _suggestA11yFixes.suggestA11yFixesInputSchema,
-  tool: _suggestA11yFixes.listSuggestA11yFixesTool
-});
+var getToolRegistry = exports.getToolRegistry = function getToolRegistry() {
+  var baseTools = (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _analyzeA11y.listAnalyzeA11yTool.name, {
+    handler: _analyzeA11y.analyzeA11yTool,
+    inputSchema: _analyzeA11y.analyzeA11yInputSchema,
+    tool: _analyzeA11y.listAnalyzeA11yTool
+  }), _analyzeA11y.listAnalyzeLocalhostA11yTool.name, {
+    handler: _analyzeA11y.analyzeLocalhostA11yTool,
+    inputSchema: _analyzeA11y.analyzeA11yLocalhostInputSchema,
+    tool: _analyzeA11y.listAnalyzeLocalhostA11yTool
+  }), _getA11yGuidelines.listGetA11yGuidelinesTool.name, {
+    handler: _getA11yGuidelines.getA11yGuidelinesTool,
+    inputSchema: _getA11yGuidelines.getA11yGuidelinesInputSchema,
+    tool: _getA11yGuidelines.listGetA11yGuidelinesTool
+  }), _getAllIcons.listGetAllIconsTool.name, {
+    handler: _getAllIcons.getAllIconsTool,
+    inputSchema: null,
+    tool: _getAllIcons.listGetAllIconsTool
+  }), _getComponents.listGetComponentsTool.name, {
+    handler: _getComponents.getComponentsTool,
+    inputSchema: null,
+    tool: _getComponents.listGetComponentsTool
+  }), _plan.listPlanTool.name, {
+    handler: _plan.planTool,
+    inputSchema: _plan.planInputSchema,
+    tool: _plan.listPlanTool
+  }), _suggestA11yFixes.listSuggestA11yFixesTool.name, {
+    handler: _suggestA11yFixes.suggestA11yFixesTool,
+    inputSchema: _suggestA11yFixes.suggestA11yFixesInputSchema,
+    tool: _suggestA11yFixes.listSuggestA11yFixesTool
+  });
+
+  // Conditionally add token tools based on feature flag
+  if ((0, _platformFeatureFlags.fg)('design_system_mcp_structured_content')) {
+    baseTools[_getTokens.listGetTokensTool.name] = {
+      handler: _getTokens.getTokensTool,
+      inputSchema: _getTokens.getTokensInputSchema,
+      tool: _getTokens.listGetTokensTool
+    };
+  } else {
+    baseTools[_getAllTokens.listGetAllTokensTool.name] = {
+      handler: _getAllTokens.getAllTokensTool,
+      inputSchema: null,
+      tool: _getAllTokens.listGetAllTokensTool
+    };
+  }
+  return baseTools;
+};
 server.setRequestHandler(_types.ListToolsRequestSchema, /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(request, extra) {
-    var tools;
+    var toolRegistry, tools;
     return _regenerator.default.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
+          toolRegistry = getToolRegistry();
           tools = Object.values(toolRegistry).map(function (toolConfig) {
             return toolConfig.tool;
           }); // Track list tools request
@@ -112,7 +129,7 @@ server.setRequestHandler(_types.ListToolsRequestSchema, /*#__PURE__*/function ()
           return _context.abrupt("return", {
             tools: tools
           });
-        case 3:
+        case 4:
         case "end":
           return _context.stop();
       }
@@ -126,10 +143,11 @@ server.setRequestHandler(_types.ListToolsRequestSchema, /*#__PURE__*/function ()
 // Handle tool execution
 server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function () {
   var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(request, extra) {
-    var toolName, toolConfig, actionSubject, toolArguments, inputValidation, result;
+    var toolRegistry, toolName, toolConfig, actionSubject, toolArguments, inputValidation, result, toolRegistryForError;
     return _regenerator.default.wrap(function _callee2$(_context2) {
       while (1) switch (_context2.prev = _context2.next) {
         case 0:
+          toolRegistry = getToolRegistry();
           toolName = request.params.name;
           toolConfig = toolRegistry[toolName];
           actionSubject = "ads.mcp.callTool"; // Track call tool request
@@ -144,17 +162,17 @@ server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function ()
             }
           });
           if (!toolConfig) {
-            _context2.next = 23;
+            _context2.next = 24;
             break;
           }
-          _context2.prev = 5;
+          _context2.prev = 6;
           if (!toolConfig.inputSchema) {
-            _context2.next = 12;
+            _context2.next = 13;
             break;
           }
           inputValidation = (0, _validation.validateToolArguments)(toolConfig.inputSchema, request.params.arguments);
           if (inputValidation.success) {
-            _context2.next = 11;
+            _context2.next = 12;
             break;
           }
           (0, _analytics.sendOperationalEvent)({
@@ -170,12 +188,12 @@ server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function ()
             }
           });
           return _context2.abrupt("return", inputValidation.error);
-        case 11:
-          toolArguments = inputValidation.data;
         case 12:
-          _context2.next = 14;
+          toolArguments = inputValidation.data;
+        case 13:
+          _context2.next = 15;
           return toolConfig.handler(toolArguments);
-        case 14:
+        case 15:
           result = _context2.sent;
           // Track successful tool execution
           (0, _analytics.sendOperationalEvent)({
@@ -189,9 +207,9 @@ server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function ()
             }
           });
           return _context2.abrupt("return", result);
-        case 19:
-          _context2.prev = 19;
-          _context2.t0 = _context2["catch"](5);
+        case 20:
+          _context2.prev = 20;
+          _context2.t0 = _context2["catch"](6);
           // Track tool execution error
           (0, _analytics.sendOperationalEvent)({
             action: 'failed',
@@ -210,7 +228,7 @@ server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function ()
           - when used alone, without the throw new McpError, it causes "Client error for command...", which will loop back to this catch
           */
           throw new _types.McpError(-32000, "Failed to execute '".concat(toolName, "' tool: ").concat(_context2.t0 instanceof Error ? _context2.t0.message : 'Unknown error'));
-        case 23:
+        case 24:
           // Track tool not found error
           (0, _analytics.sendOperationalEvent)({
             action: 'notFound',
@@ -222,13 +240,14 @@ server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function ()
               extra: extra
             }
           });
-          console.error("Tool '".concat(request.params.name, "' not found, only the following tools are available: ").concat(Object.keys(toolRegistry).join(', ')));
+          toolRegistryForError = getToolRegistry();
+          console.error("Tool '".concat(request.params.name, "' not found, only the following tools are available: ").concat(Object.keys(toolRegistryForError).join(', ')));
           return _context2.abrupt("return");
-        case 26:
+        case 28:
         case "end":
           return _context2.stop();
       }
-    }, _callee2, null, [[5, 19]]);
+    }, _callee2, null, [[6, 20]]);
   }));
   return function (_x3, _x4) {
     return _ref2.apply(this, arguments);
@@ -269,4 +288,6 @@ function _runServer() {
 runServer().catch(function (error) {
   var errorMessage = error instanceof Error ? error.message : 'Unknown error';
   console.error("Invalid input to ads-mcp: ".concat(errorMessage));
-});
+});
+
+// Export types for use by other packages

package/dist/cjs/structured-content/formatters/token.js

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.tokenToMarkdown = tokenToMarkdown;
+function tokenToMarkdown(token) {
+  return "# ".concat(token.name, "\n\n").concat(token.description, "\n\nExample Value: `").concat(token.exampleValue, "`\n");
+}
+
+// When it comes time to generate HTML content, we can add `tokenToHtml` here.

package/dist/cjs/structured-content/types.js

@@ -0,0 +1 @@
+"use strict";

package/dist/cjs/tools/get-a11y-guidelines/guidelines.js

@@ -87,10 +87,10 @@ var accessibilityGuidelines = exports.accessibilityGuidelines = {
   screenReaders: {
     title: 'Screen Reader Support',
     description: 'Guidelines for screen reader accessibility',
-    guidelines: ['Use Announcer component for dynamic content', 'Provide skip links for keyboard users', 'Use proper heading hierarchy', 'Use semantic HTML elements', 'Provide live regions for status updates', 'Use VisuallyHidden for screen reader text'],
+    guidelines: ['Use aria-live regions for dynamic content announcements', 'Provide skip links for keyboard users', 'Use proper heading hierarchy', 'Use semantic HTML elements', 'Provide live regions for status updates', 'Use VisuallyHidden for screen reader text'],
     codeExamples: [{
       title: 'Screen Reader Announcements',
-      code: "import { Announcer } from '@atlaskit/announcer';\n\n<Announcer\n  message={`${count} items selected`}\n  liveMode=\"polite\"\n  shouldAnnounce={true}\n/>"
+      code: "<div aria-live=\"polite\" role=\"status\">\n  {count} items selected\n</div>"
     }, {
       title: 'Skip Links',
       code: "<a href=\"#main-content\" className=\"skip-link\">\n  Skip to main content\n</a>"

package/dist/cjs/tools/get-tokens/index.js

@@ -0,0 +1,130 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.listGetTokensTool = exports.getTokensTool = exports.getTokensInputSchema = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _fuse = _interopRequireDefault(require("fuse.js"));
+var _zod = require("zod");
+var _zodToJsonSchema = require("zod-to-json-schema");
+var _tokenMetadata = require("@atlaskit/tokens/token-metadata");
+var _helpers = require("../../helpers");
+var _token = require("../../structured-content/formatters/token");
+// Transform Token[] from token-metadata to TokenSchema[] format
+function transformTokensToSchemas() {
+  return _tokenMetadata.tokens.map(function (token) {
+    var _token$exampleValue;
+    return {
+      contentType: 'token',
+      name: token.name,
+      path: token.path,
+      description: token.description,
+      exampleValue: String((_token$exampleValue = token.exampleValue) !== null && _token$exampleValue !== void 0 ? _token$exampleValue : '')
+    };
+  });
+}
+var getTokensInputSchema = exports.getTokensInputSchema = _zod.z.object({
+  terms: _zod.z.array(_zod.z.string()).default([]).describe('An array of search terms to find tokens by name or description, eg. `["spacing", "inverted text", "background primary"]`. If empty or not provided, returns all tokens.').optional(),
+  limit: _zod.z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
+  exactName: _zod.z.boolean().default(false).describe('Enable to explicitly search tokens by the exact name match (when you know the name, but need more details)').optional()
+});
+var listGetTokensTool = exports.listGetTokensTool = {
+  name: 'ads_get_tokens',
+  description: "Get Atlassian Design System tokens with optional search functionality.\n\n- If search parameters are provided, searches for tokens matching the criteria.\n- If no search parameters are provided, returns all tokens.\n\nExample token usage:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```",
+  annotations: {
+    title: 'Get ADS tokens',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(getTokensInputSchema)
+};
+var getTokensTool = exports.getTokensTool = /*#__PURE__*/function () {
+  var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
+    var _params$terms, terms, _params$limit, limit, _params$exactName, exactName, searchTerms, tokenDocs, allTokensMarkdown, exactNameMatches, _formattedTokens, fuse, results, uniqueResults, matchedTokens, formattedTokens;
+    return _regenerator.default.wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          _params$terms = params.terms, terms = _params$terms === void 0 ? [] : _params$terms, _params$limit = params.limit, limit = _params$limit === void 0 ? 1 : _params$limit, _params$exactName = params.exactName, exactName = _params$exactName === void 0 ? false : _params$exactName;
+          searchTerms = terms.filter(Boolean).map(_helpers.cleanQuery);
+          tokenDocs = transformTokensToSchemas(); // If no search terms provided, return all tokens formatted as Markdown
+          if (!(searchTerms.length === 0)) {
+            _context.next = 6;
+            break;
+          }
+          allTokensMarkdown = tokenDocs.map(_token.tokenToMarkdown).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: allTokensMarkdown
+            }]
+          });
+        case 6:
+          if (!exactName) {
+            _context.next = 11;
+            break;
+          }
+          // for each search term, search for the exact match
+          exactNameMatches = searchTerms.map(function (term) {
+            return tokenDocs.find(function (token) {
+              return token.name.toLowerCase() === term.toLowerCase();
+            });
+          }).filter(Boolean);
+          if (!(exactNameMatches.length > 0)) {
+            _context.next = 11;
+            break;
+          }
+          _formattedTokens = exactNameMatches.map(_token.tokenToMarkdown).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: _formattedTokens
+            }]
+          });
+        case 11:
+          // use Fuse.js to fuzzy-search for the tokens
+          fuse = new _fuse.default(tokenDocs, {
+            keys: [{
+              name: 'name',
+              weight: 3
+            }, {
+              name: 'description',
+              weight: 2
+            }, {
+              name: 'exampleValue',
+              weight: 1
+            }],
+            threshold: 0.4
+          });
+          results = searchTerms.map(function (term) {
+            return fuse.search(term).slice(0, limit);
+          }).flat(); // Remove duplicates based on token name
+          uniqueResults = results.filter(function (result, index, arr) {
+            return arr.findIndex(function (r) {
+              return r.item.name === result.item.name;
+            }) === index;
+          });
+          matchedTokens = uniqueResults.map(function (result) {
+            return result.item;
+          });
+          formattedTokens = matchedTokens.map(_token.tokenToMarkdown).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: formattedTokens
+            }]
+          });
+        case 17:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function getTokensTool(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();

package/dist/es2019/index.js

@@ -2,6 +2,7 @@
 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 { fg } from '@atlaskit/platform-feature-flags';
 import { sendOperationalEvent } from './helpers/analytics';
 import { validateToolArguments } from './helpers/validation';
 import { instructions } from './instructions';
@@ -10,6 +11,7 @@ import { getA11yGuidelinesInputSchema, getA11yGuidelinesTool, listGetA11yGuideli
 import { getAllIconsTool, listGetAllIconsTool } from './tools/get-all-icons';
 import { getAllTokensTool, listGetAllTokensTool } from './tools/get-all-tokens';
 import { getComponentsTool, listGetComponentsTool } from './tools/get-components';
+import { getTokensInputSchema, getTokensTool, listGetTokensTool } from './tools/get-tokens';
 import { listPlanTool, planInputSchema, planTool } from './tools/plan';
 import { listSuggestA11yFixesTool, suggestA11yFixesInputSchema, suggestA11yFixesTool } from './tools/suggest-a11y-fixes';
 
@@ -41,66 +43,80 @@ const generateLogger = level => (...args) => {
     console.error(`[ads-mcp.custom-logging][${level}]`, ...args);
   }
 };
-export const toolRegistry = {
-  [listAnalyzeA11yTool.name]: {
-    handler: analyzeA11yTool,
-    inputSchema: analyzeA11yInputSchema,
-    tool: listAnalyzeA11yTool
-  },
-  [listAnalyzeLocalhostA11yTool.name]: {
-    handler: analyzeLocalhostA11yTool,
-    inputSchema: analyzeA11yLocalhostInputSchema,
-    tool: listAnalyzeLocalhostA11yTool
-  },
-  [listGetA11yGuidelinesTool.name]: {
-    handler: getA11yGuidelinesTool,
-    inputSchema: getA11yGuidelinesInputSchema,
-    tool: listGetA11yGuidelinesTool
-  },
-  [listGetAllIconsTool.name]: {
-    handler: getAllIconsTool,
-    inputSchema: null,
-    tool: listGetAllIconsTool
-  },
-  [listGetAllTokensTool.name]: {
-    handler: getAllTokensTool,
-    inputSchema: null,
-    tool: listGetAllTokensTool
-  },
-  [listGetComponentsTool.name]: {
-    handler: getComponentsTool,
-    inputSchema: null,
-    tool: listGetComponentsTool
-  },
-  [listPlanTool.name]: {
-    handler: planTool,
-    inputSchema: planInputSchema,
-    tool: listPlanTool
-  },
-  // NOTE: These should not actually be called as they're not in the `list_tools` endpoint.
-  // But there might be a reason to keep them around for backwards-compatibility.
-  // [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
+export const getToolRegistry = () => {
+  const baseTools = {
+    [listAnalyzeA11yTool.name]: {
+      handler: analyzeA11yTool,
+      inputSchema: analyzeA11yInputSchema,
+      tool: listAnalyzeA11yTool
+    },
+    [listAnalyzeLocalhostA11yTool.name]: {
+      handler: analyzeLocalhostA11yTool,
+      inputSchema: analyzeA11yLocalhostInputSchema,
+      tool: listAnalyzeLocalhostA11yTool
+    },
+    [listGetA11yGuidelinesTool.name]: {
+      handler: getA11yGuidelinesTool,
+      inputSchema: getA11yGuidelinesInputSchema,
+      tool: listGetA11yGuidelinesTool
+    },
+    [listGetAllIconsTool.name]: {
+      handler: getAllIconsTool,
+      inputSchema: null,
+      tool: listGetAllIconsTool
+    },
+    [listGetComponentsTool.name]: {
+      handler: getComponentsTool,
+      inputSchema: null,
+      tool: listGetComponentsTool
+    },
+    [listPlanTool.name]: {
+      handler: planTool,
+      inputSchema: planInputSchema,
+      tool: listPlanTool
+    },
+    // NOTE: These should not actually be called as they're not in the `list_tools` endpoint.
+    // But there might be a reason to keep them around for backwards-compatibility.
+    // [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
+    }
+  };
+
+  // Conditionally add token tools based on feature flag
+  if (fg('design_system_mcp_structured_content')) {
+    baseTools[listGetTokensTool.name] = {
+      handler: getTokensTool,
+      inputSchema: getTokensInputSchema,
+      tool: listGetTokensTool
+    };
+  } else {
+    baseTools[listGetAllTokensTool.name] = {
+      handler: getAllTokensTool,
+      inputSchema: null,
+      tool: listGetAllTokensTool
+    };
   }
+  return baseTools;
 };
 server.setRequestHandler(ListToolsRequestSchema, async (request, extra) => {
+  const toolRegistry = getToolRegistry();
   const tools = Object.values(toolRegistry).map(toolConfig => toolConfig.tool);
 
   // Track list tools request
@@ -121,6 +137,7 @@ server.setRequestHandler(ListToolsRequestSchema, async (request, extra) => {
 
 // Handle tool execution
 server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+  const toolRegistry = getToolRegistry();
   const toolName = request.params.name;
   const toolConfig = toolRegistry[toolName];
   const actionSubject = `ads.mcp.callTool`;
@@ -204,7 +221,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
       extra
     }
   });
-  console.error(`Tool '${request.params.name}' not found, only the following tools are available: ${Object.keys(toolRegistry).join(', ')}`);
+  const toolRegistryForError = getToolRegistry();
+  console.error(`Tool '${request.params.name}' not found, only the following tools are available: ${Object.keys(toolRegistryForError).join(', ')}`);
   return;
 });
 async function runServer() {
@@ -226,4 +244,6 @@ async function runServer() {
 runServer().catch(error => {
   const errorMessage = error instanceof Error ? error.message : 'Unknown error';
   console.error(`Invalid input to ads-mcp: ${errorMessage}`);
-});
+});
+
+// Export types for use by other packages

package/dist/es2019/structured-content/formatters/token.js

@@ -0,0 +1,10 @@
+export function tokenToMarkdown(token) {
+  return `# ${token.name}
+
+${token.description}
+
+Example Value: \`${token.exampleValue}\`
+`;
+}
+
+// When it comes time to generate HTML content, we can add `tokenToHtml` here.

package/dist/es2019/tools/get-a11y-guidelines/guidelines.js

@@ -165,16 +165,12 @@ useEffect(() => {
   screenReaders: {
     title: 'Screen Reader Support',
     description: 'Guidelines for screen reader accessibility',
-    guidelines: ['Use Announcer component for dynamic content', 'Provide skip links for keyboard users', 'Use proper heading hierarchy', 'Use semantic HTML elements', 'Provide live regions for status updates', 'Use VisuallyHidden for screen reader text'],
+    guidelines: ['Use aria-live regions for dynamic content announcements', 'Provide skip links for keyboard users', 'Use proper heading hierarchy', 'Use semantic HTML elements', 'Provide live regions for status updates', 'Use VisuallyHidden for screen reader text'],
     codeExamples: [{
       title: 'Screen Reader Announcements',
-      code: `import { Announcer } from '@atlaskit/announcer';
-
-<Announcer
-  message={\`\${count} items selected\`}
-  liveMode="polite"
-  shouldAnnounce={true}
-/>`
+      code: `<div aria-live="polite" role="status">
+  {count} items selected
+</div>`
     }, {
       title: 'Skip Links',
       code: `<a href="#main-content" className="skip-link">

package/dist/es2019/tools/get-tokens/index.js

@@ -0,0 +1,113 @@
+import Fuse from 'fuse.js';
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { tokens } from '@atlaskit/tokens/token-metadata';
+import { cleanQuery } from '../../helpers';
+import { tokenToMarkdown } from '../../structured-content/formatters/token';
+// Transform Token[] from token-metadata to TokenSchema[] format
+function transformTokensToSchemas() {
+  return tokens.map(token => {
+    var _token$exampleValue;
+    return {
+      contentType: 'token',
+      name: token.name,
+      path: token.path,
+      description: token.description,
+      exampleValue: String((_token$exampleValue = token.exampleValue) !== null && _token$exampleValue !== void 0 ? _token$exampleValue : '')
+    };
+  });
+}
+export const getTokensInputSchema = z.object({
+  terms: z.array(z.string()).default([]).describe('An array of search terms to find tokens by name or description, eg. `["spacing", "inverted text", "background primary"]`. If empty or not provided, returns all tokens.').optional(),
+  limit: z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
+  exactName: z.boolean().default(false).describe('Enable to explicitly search tokens by the exact name match (when you know the name, but need more details)').optional()
+});
+export const listGetTokensTool = {
+  name: 'ads_get_tokens',
+  description: `Get Atlassian Design System tokens with optional search functionality.
+
+- If search parameters are provided, searches for tokens matching the criteria.
+- If no search parameters are provided, returns all tokens.
+
+Example token usage:
+\`\`\`tsx
+import { token } from '@atlaskit/tokens';
+const styles = css({ color: token('color.text'), padding: token('space.100') });
+\`\`\``,
+  annotations: {
+    title: 'Get ADS tokens',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(getTokensInputSchema)
+};
+export const getTokensTool = async params => {
+  const {
+    terms = [],
+    limit = 1,
+    exactName = false
+  } = params;
+  const searchTerms = terms.filter(Boolean).map(cleanQuery);
+  const tokenDocs = transformTokensToSchemas();
+
+  // If no search terms provided, return all tokens formatted as Markdown
+  if (searchTerms.length === 0) {
+    const allTokensMarkdown = tokenDocs.map(tokenToMarkdown).join('\n\n');
+    return {
+      content: [{
+        type: 'text',
+        text: allTokensMarkdown
+      }]
+    };
+  }
+
+  // Search logic (same as search-tokens)
+  if (exactName) {
+    // for each search term, search for the exact match
+    const exactNameMatches = searchTerms.map(term => {
+      return tokenDocs.find(token => token.name.toLowerCase() === term.toLowerCase());
+    }).filter(Boolean);
+    if (exactNameMatches.length > 0) {
+      const formattedTokens = exactNameMatches.map(tokenToMarkdown).join('\n\n');
+      return {
+        content: [{
+          type: 'text',
+          text: formattedTokens
+        }]
+      };
+    }
+  }
+
+  // use Fuse.js to fuzzy-search for the tokens
+  const fuse = new Fuse(tokenDocs, {
+    keys: [{
+      name: 'name',
+      weight: 3
+    }, {
+      name: 'description',
+      weight: 2
+    }, {
+      name: 'exampleValue',
+      weight: 1
+    }],
+    threshold: 0.4
+  });
+  const results = searchTerms.map(term => {
+    return fuse.search(term).slice(0, limit);
+  }).flat();
+
+  // Remove duplicates based on token name
+  const uniqueResults = results.filter((result, index, arr) => {
+    return arr.findIndex(r => r.item.name === result.item.name) === index;
+  });
+  const matchedTokens = uniqueResults.map(result => result.item);
+  const formattedTokens = matchedTokens.map(tokenToMarkdown).join('\n\n');
+  return {
+    content: [{
+      type: 'text',
+      text: formattedTokens
+    }]
+  };
+};

package/dist/esm/index.js

@@ -5,6 +5,7 @@ import _regeneratorRuntime from "@babel/runtime/regenerator";
 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 { fg } from '@atlaskit/platform-feature-flags';
 import { sendOperationalEvent } from './helpers/analytics';
 import { validateToolArguments } from './helpers/validation';
 import { instructions } from './instructions';
@@ -13,6 +14,7 @@ import { getA11yGuidelinesInputSchema, getA11yGuidelinesTool, listGetA11yGuideli
 import { getAllIconsTool, listGetAllIconsTool } from './tools/get-all-icons';
 import { getAllTokensTool, listGetAllTokensTool } from './tools/get-all-tokens';
 import { getComponentsTool, listGetComponentsTool } from './tools/get-components';
+import { getTokensInputSchema, getTokensTool, listGetTokensTool } from './tools/get-tokens';
 import { listPlanTool, planInputSchema, planTool } from './tools/plan';
 import { listSuggestA11yFixesTool, suggestA11yFixesInputSchema, suggestA11yFixesTool } from './tools/suggest-a11y-fixes';
 
@@ -50,45 +52,60 @@ var generateLogger = function generateLogger(level) {
     }
   };
 };
-export var toolRegistry = _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, listAnalyzeA11yTool.name, {
-  handler: analyzeA11yTool,
-  inputSchema: analyzeA11yInputSchema,
-  tool: listAnalyzeA11yTool
-}), listAnalyzeLocalhostA11yTool.name, {
-  handler: analyzeLocalhostA11yTool,
-  inputSchema: analyzeA11yLocalhostInputSchema,
-  tool: listAnalyzeLocalhostA11yTool
-}), listGetA11yGuidelinesTool.name, {
-  handler: getA11yGuidelinesTool,
-  inputSchema: getA11yGuidelinesInputSchema,
-  tool: listGetA11yGuidelinesTool
-}), listGetAllIconsTool.name, {
-  handler: getAllIconsTool,
-  inputSchema: null,
-  tool: listGetAllIconsTool
-}), listGetAllTokensTool.name, {
-  handler: getAllTokensTool,
-  inputSchema: null,
-  tool: listGetAllTokensTool
-}), listGetComponentsTool.name, {
-  handler: getComponentsTool,
-  inputSchema: null,
-  tool: listGetComponentsTool
-}), listPlanTool.name, {
-  handler: planTool,
-  inputSchema: planInputSchema,
-  tool: listPlanTool
-}), listSuggestA11yFixesTool.name, {
-  handler: suggestA11yFixesTool,
-  inputSchema: suggestA11yFixesInputSchema,
-  tool: listSuggestA11yFixesTool
-});
+export var getToolRegistry = function getToolRegistry() {
+  var baseTools = _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, listAnalyzeA11yTool.name, {
+    handler: analyzeA11yTool,
+    inputSchema: analyzeA11yInputSchema,
+    tool: listAnalyzeA11yTool
+  }), listAnalyzeLocalhostA11yTool.name, {
+    handler: analyzeLocalhostA11yTool,
+    inputSchema: analyzeA11yLocalhostInputSchema,
+    tool: listAnalyzeLocalhostA11yTool
+  }), listGetA11yGuidelinesTool.name, {
+    handler: getA11yGuidelinesTool,
+    inputSchema: getA11yGuidelinesInputSchema,
+    tool: listGetA11yGuidelinesTool
+  }), listGetAllIconsTool.name, {
+    handler: getAllIconsTool,
+    inputSchema: null,
+    tool: listGetAllIconsTool
+  }), listGetComponentsTool.name, {
+    handler: getComponentsTool,
+    inputSchema: null,
+    tool: listGetComponentsTool
+  }), listPlanTool.name, {
+    handler: planTool,
+    inputSchema: planInputSchema,
+    tool: listPlanTool
+  }), listSuggestA11yFixesTool.name, {
+    handler: suggestA11yFixesTool,
+    inputSchema: suggestA11yFixesInputSchema,
+    tool: listSuggestA11yFixesTool
+  });
+
+  // Conditionally add token tools based on feature flag
+  if (fg('design_system_mcp_structured_content')) {
+    baseTools[listGetTokensTool.name] = {
+      handler: getTokensTool,
+      inputSchema: getTokensInputSchema,
+      tool: listGetTokensTool
+    };
+  } else {
+    baseTools[listGetAllTokensTool.name] = {
+      handler: getAllTokensTool,
+      inputSchema: null,
+      tool: listGetAllTokensTool
+    };
+  }
+  return baseTools;
+};
 server.setRequestHandler(ListToolsRequestSchema, /*#__PURE__*/function () {
   var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(request, extra) {
-    var tools;
+    var toolRegistry, tools;
     return _regeneratorRuntime.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
+          toolRegistry = getToolRegistry();
           tools = Object.values(toolRegistry).map(function (toolConfig) {
             return toolConfig.tool;
           }); // Track list tools request
@@ -105,7 +122,7 @@ server.setRequestHandler(ListToolsRequestSchema, /*#__PURE__*/function () {
           return _context.abrupt("return", {
             tools: tools
           });
-        case 3:
+        case 4:
         case "end":
           return _context.stop();
       }
@@ -119,10 +136,11 @@ server.setRequestHandler(ListToolsRequestSchema, /*#__PURE__*/function () {
 // Handle tool execution
 server.setRequestHandler(CallToolRequestSchema, /*#__PURE__*/function () {
   var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(request, extra) {
-    var toolName, toolConfig, actionSubject, toolArguments, inputValidation, result;
+    var toolRegistry, toolName, toolConfig, actionSubject, toolArguments, inputValidation, result, toolRegistryForError;
     return _regeneratorRuntime.wrap(function _callee2$(_context2) {
       while (1) switch (_context2.prev = _context2.next) {
         case 0:
+          toolRegistry = getToolRegistry();
           toolName = request.params.name;
           toolConfig = toolRegistry[toolName];
           actionSubject = "ads.mcp.callTool"; // Track call tool request
@@ -137,17 +155,17 @@ server.setRequestHandler(CallToolRequestSchema, /*#__PURE__*/function () {
             }
           });
           if (!toolConfig) {
-            _context2.next = 23;
+            _context2.next = 24;
             break;
           }
-          _context2.prev = 5;
+          _context2.prev = 6;
           if (!toolConfig.inputSchema) {
-            _context2.next = 12;
+            _context2.next = 13;
             break;
           }
           inputValidation = validateToolArguments(toolConfig.inputSchema, request.params.arguments);
           if (inputValidation.success) {
-            _context2.next = 11;
+            _context2.next = 12;
             break;
           }
           sendOperationalEvent({
@@ -163,12 +181,12 @@ server.setRequestHandler(CallToolRequestSchema, /*#__PURE__*/function () {
             }
           });
           return _context2.abrupt("return", inputValidation.error);
-        case 11:
-          toolArguments = inputValidation.data;
         case 12:
-          _context2.next = 14;
+          toolArguments = inputValidation.data;
+        case 13:
+          _context2.next = 15;
           return toolConfig.handler(toolArguments);
-        case 14:
+        case 15:
           result = _context2.sent;
           // Track successful tool execution
           sendOperationalEvent({
@@ -182,9 +200,9 @@ server.setRequestHandler(CallToolRequestSchema, /*#__PURE__*/function () {
             }
           });
           return _context2.abrupt("return", result);
-        case 19:
-          _context2.prev = 19;
-          _context2.t0 = _context2["catch"](5);
+        case 20:
+          _context2.prev = 20;
+          _context2.t0 = _context2["catch"](6);
           // Track tool execution error
           sendOperationalEvent({
             action: 'failed',
@@ -203,7 +221,7 @@ server.setRequestHandler(CallToolRequestSchema, /*#__PURE__*/function () {
           - when used alone, without the throw new McpError, it causes "Client error for command...", which will loop back to this catch
           */
           throw new McpError(-32000, "Failed to execute '".concat(toolName, "' tool: ").concat(_context2.t0 instanceof Error ? _context2.t0.message : 'Unknown error'));
-        case 23:
+        case 24:
           // Track tool not found error
           sendOperationalEvent({
             action: 'notFound',
@@ -215,13 +233,14 @@ server.setRequestHandler(CallToolRequestSchema, /*#__PURE__*/function () {
               extra: extra
             }
           });
-          console.error("Tool '".concat(request.params.name, "' not found, only the following tools are available: ").concat(Object.keys(toolRegistry).join(', ')));
+          toolRegistryForError = getToolRegistry();
+          console.error("Tool '".concat(request.params.name, "' not found, only the following tools are available: ").concat(Object.keys(toolRegistryForError).join(', ')));
           return _context2.abrupt("return");
-        case 26:
+        case 28:
         case "end":
           return _context2.stop();
       }
-    }, _callee2, null, [[5, 19]]);
+    }, _callee2, null, [[6, 20]]);
   }));
   return function (_x3, _x4) {
     return _ref2.apply(this, arguments);
@@ -262,4 +281,6 @@ function _runServer() {
 runServer().catch(function (error) {
   var errorMessage = error instanceof Error ? error.message : 'Unknown error';
   console.error("Invalid input to ads-mcp: ".concat(errorMessage));
-});
+});
+
+// Export types for use by other packages

package/dist/esm/structured-content/formatters/token.js

@@ -0,0 +1,5 @@
+export function tokenToMarkdown(token) {
+  return "# ".concat(token.name, "\n\n").concat(token.description, "\n\nExample Value: `").concat(token.exampleValue, "`\n");
+}
+
+// When it comes time to generate HTML content, we can add `tokenToHtml` here.

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

@@ -81,10 +81,10 @@ export var accessibilityGuidelines = {
   screenReaders: {
     title: 'Screen Reader Support',
     description: 'Guidelines for screen reader accessibility',
-    guidelines: ['Use Announcer component for dynamic content', 'Provide skip links for keyboard users', 'Use proper heading hierarchy', 'Use semantic HTML elements', 'Provide live regions for status updates', 'Use VisuallyHidden for screen reader text'],
+    guidelines: ['Use aria-live regions for dynamic content announcements', 'Provide skip links for keyboard users', 'Use proper heading hierarchy', 'Use semantic HTML elements', 'Provide live regions for status updates', 'Use VisuallyHidden for screen reader text'],
     codeExamples: [{
       title: 'Screen Reader Announcements',
-      code: "import { Announcer } from '@atlaskit/announcer';\n\n<Announcer\n  message={`${count} items selected`}\n  liveMode=\"polite\"\n  shouldAnnounce={true}\n/>"
+      code: "<div aria-live=\"polite\" role=\"status\">\n  {count} items selected\n</div>"
     }, {
       title: 'Skip Links',
       code: "<a href=\"#main-content\" className=\"skip-link\">\n  Skip to main content\n</a>"

package/dist/esm/tools/get-tokens/index.js

@@ -0,0 +1,123 @@
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _regeneratorRuntime from "@babel/runtime/regenerator";
+import Fuse from 'fuse.js';
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { tokens } from '@atlaskit/tokens/token-metadata';
+import { cleanQuery } from '../../helpers';
+import { tokenToMarkdown } from '../../structured-content/formatters/token';
+// Transform Token[] from token-metadata to TokenSchema[] format
+function transformTokensToSchemas() {
+  return tokens.map(function (token) {
+    var _token$exampleValue;
+    return {
+      contentType: 'token',
+      name: token.name,
+      path: token.path,
+      description: token.description,
+      exampleValue: String((_token$exampleValue = token.exampleValue) !== null && _token$exampleValue !== void 0 ? _token$exampleValue : '')
+    };
+  });
+}
+export var getTokensInputSchema = z.object({
+  terms: z.array(z.string()).default([]).describe('An array of search terms to find tokens by name or description, eg. `["spacing", "inverted text", "background primary"]`. If empty or not provided, returns all tokens.').optional(),
+  limit: z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
+  exactName: z.boolean().default(false).describe('Enable to explicitly search tokens by the exact name match (when you know the name, but need more details)').optional()
+});
+export var listGetTokensTool = {
+  name: 'ads_get_tokens',
+  description: "Get Atlassian Design System tokens with optional search functionality.\n\n- If search parameters are provided, searches for tokens matching the criteria.\n- If no search parameters are provided, returns all tokens.\n\nExample token usage:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```",
+  annotations: {
+    title: 'Get ADS tokens',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(getTokensInputSchema)
+};
+export var getTokensTool = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
+    var _params$terms, terms, _params$limit, limit, _params$exactName, exactName, searchTerms, tokenDocs, allTokensMarkdown, exactNameMatches, _formattedTokens, fuse, results, uniqueResults, matchedTokens, formattedTokens;
+    return _regeneratorRuntime.wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          _params$terms = params.terms, terms = _params$terms === void 0 ? [] : _params$terms, _params$limit = params.limit, limit = _params$limit === void 0 ? 1 : _params$limit, _params$exactName = params.exactName, exactName = _params$exactName === void 0 ? false : _params$exactName;
+          searchTerms = terms.filter(Boolean).map(cleanQuery);
+          tokenDocs = transformTokensToSchemas(); // If no search terms provided, return all tokens formatted as Markdown
+          if (!(searchTerms.length === 0)) {
+            _context.next = 6;
+            break;
+          }
+          allTokensMarkdown = tokenDocs.map(tokenToMarkdown).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: allTokensMarkdown
+            }]
+          });
+        case 6:
+          if (!exactName) {
+            _context.next = 11;
+            break;
+          }
+          // for each search term, search for the exact match
+          exactNameMatches = searchTerms.map(function (term) {
+            return tokenDocs.find(function (token) {
+              return token.name.toLowerCase() === term.toLowerCase();
+            });
+          }).filter(Boolean);
+          if (!(exactNameMatches.length > 0)) {
+            _context.next = 11;
+            break;
+          }
+          _formattedTokens = exactNameMatches.map(tokenToMarkdown).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: _formattedTokens
+            }]
+          });
+        case 11:
+          // use Fuse.js to fuzzy-search for the tokens
+          fuse = new Fuse(tokenDocs, {
+            keys: [{
+              name: 'name',
+              weight: 3
+            }, {
+              name: 'description',
+              weight: 2
+            }, {
+              name: 'exampleValue',
+              weight: 1
+            }],
+            threshold: 0.4
+          });
+          results = searchTerms.map(function (term) {
+            return fuse.search(term).slice(0, limit);
+          }).flat(); // Remove duplicates based on token name
+          uniqueResults = results.filter(function (result, index, arr) {
+            return arr.findIndex(function (r) {
+              return r.item.name === result.item.name;
+            }) === index;
+          });
+          matchedTokens = uniqueResults.map(function (result) {
+            return result.item;
+          });
+          formattedTokens = matchedTokens.map(tokenToMarkdown).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: formattedTokens
+            }]
+          });
+        case 17:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function getTokensTool(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();

package/dist/types/index.d.ts

@@ -1,7 +1,8 @@
 import { type Tool } from '@modelcontextprotocol/sdk/types.js';
 import type { z } from 'zod';
-export declare const toolRegistry: Record<string, {
+export declare const getToolRegistry: () => Record<string, {
     handler: (params: any) => Promise<any>;
-    inputSchema: z.ZodSchema | null;
+    inputSchema: z.AnyZodObject | null;
     tool: Tool;
 }>;
+export type { TokenSchema, ContentSchema } from './structured-content/types';

package/dist/types/structured-content/formatters/token.d.ts

@@ -0,0 +1,2 @@
+import { type TokenSchema } from '../types';
+export declare function tokenToMarkdown(token: TokenSchema): string;

package/dist/types/structured-content/types.d.ts

@@ -0,0 +1,20 @@
+export type TokenSchema = {
+    contentType: 'token';
+    /**
+     * The name of the token, e.g. `color.text`
+     */
+    name: string;
+    /**
+     * The constituent parts of the tokens' name, e.g. `['color', 'text', '[default]' ]
+     */
+    path: string[];
+    /**
+     * A brief explanation of where and how to use the token
+     */
+    description: string;
+    /**
+     * CSS value to use as an example of what this token might look like
+     */
+    exampleValue: string;
+};
+export type ContentSchema = TokenSchema;

package/dist/types/tools/get-tokens/index.d.ts

@@ -0,0 +1,33 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types';
+import { z } from 'zod';
+export declare const getTokensInputSchema: z.ZodObject<{
+    terms: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    exactName: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    terms?: string[] | undefined;
+    limit?: number | undefined;
+    exactName?: boolean | undefined;
+}, {
+    terms?: string[] | undefined;
+    limit?: number | undefined;
+    exactName?: boolean | undefined;
+}>;
+export declare const listGetTokensTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const getTokensTool: (params: z.infer<typeof getTokensInputSchema>) => Promise<CallToolResult>;

package/dist/types-ts4.5/index.d.ts

@@ -1,7 +1,8 @@
 import { type Tool } from '@modelcontextprotocol/sdk/types.js';
 import type { z } from 'zod';
-export declare const toolRegistry: Record<string, {
+export declare const getToolRegistry: () => Record<string, {
     handler: (params: any) => Promise<any>;
-    inputSchema: z.ZodSchema | null;
+    inputSchema: z.AnyZodObject | null;
     tool: Tool;
 }>;
+export type { TokenSchema, ContentSchema } from './structured-content/types';

package/dist/types-ts4.5/structured-content/formatters/token.d.ts

@@ -0,0 +1,2 @@
+import { type TokenSchema } from '../types';
+export declare function tokenToMarkdown(token: TokenSchema): string;

package/dist/types-ts4.5/structured-content/types.d.ts

@@ -0,0 +1,20 @@
+export type TokenSchema = {
+    contentType: 'token';
+    /**
+     * The name of the token, e.g. `color.text`
+     */
+    name: string;
+    /**
+     * The constituent parts of the tokens' name, e.g. `['color', 'text', '[default]' ]
+     */
+    path: string[];
+    /**
+     * A brief explanation of where and how to use the token
+     */
+    description: string;
+    /**
+     * CSS value to use as an example of what this token might look like
+     */
+    exampleValue: string;
+};
+export type ContentSchema = TokenSchema;

package/dist/types-ts4.5/tools/get-tokens/index.d.ts

@@ -0,0 +1,33 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types';
+import { z } from 'zod';
+export declare const getTokensInputSchema: z.ZodObject<{
+    terms: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    exactName: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    terms?: string[] | undefined;
+    limit?: number | undefined;
+    exactName?: boolean | undefined;
+}, {
+    terms?: string[] | undefined;
+    limit?: number | undefined;
+    exactName?: boolean | undefined;
+}>;
+export declare const listGetTokensTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const getTokensTool: (params: z.infer<typeof getTokensInputSchema>) => Promise<CallToolResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/ads-mcp",
-	"version": "0.8.6",
+	"version": "0.9.1",
 	"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,9 +24,15 @@
 		}
 	},
 	"atlaskit:src": "src/index.tsx",
+	"platform-feature-flags": {
+		"design_system_mcp_structured_content": {
+			"type": "boolean"
+		}
+	},
 	"dependencies": {
 		"@atlaskit/icon": "^29.0.0",
-		"@atlaskit/tokens": "^8.2.0",
+		"@atlaskit/platform-feature-flags": "^1.1.0",
+		"@atlaskit/tokens": "^8.4.0",
 		"@axe-core/playwright": "^4.8.0",
 		"@axe-core/puppeteer": "^4.7.3",
 		"@babel/runtime": "^7.0.0",