@atlaskit/ads-mcp 1.10.11 → 1.11.0

package/dist/esm/tools/search-tokens/list-search-tokens-tool.js

@@ -4,7 +4,7 @@ import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
 import { searchTokensInputSchema } from './search-tokens-input-schema';
 export var listSearchTokensTool = {
   name: 'ads_search_tokens',
-  description: "Searches Atlassian Design System **design tokens** from bundled metadata. Returns compact JSON objects with **name** and **exampleValue** for each match by default (search also considers description, usage guidelines, and CSS property hints in metadata). Set **includeMetadata** to include usage guidelines in each result.\n\nWHEN TO USE:\n**Styling or theming in code**\u2014you need the right `token('\u2026')` names for colors, space, typography, etc. Use during layout and visual work when tokens must match ADS. Prefer `ads_plan` when you also need icons and components in the same step.\n\nExample:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```",
+  description: "Searches Atlassian Design System **design tokens** from bundled metadata. Returns compact JSON objects with **name** and **exampleValue** for each match by default (search also considers description, usage guidelines, and CSS property hints in metadata). Set **includeMetadata** to include the canonical token description from the tokens package and shared usage guidelines in each result.\n\nWHEN TO USE:\n**Styling or theming in code**\u2014you need the right `token('\u2026')` names for colors, space, typography, etc. Use during layout and visual work when tokens must match ADS. Prefer `ads_plan` when you also need icons and components in the same step.\n\nExample:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```",
   annotations: {
     title: 'Search ADS tokens',
     readOnlyHint: true,

package/dist/esm/tools/search-tokens/search-tokens-input-schema.js

@@ -4,5 +4,5 @@ import { z } from 'zod';
 export var searchTokensInputSchema = z.object({
   terms: z.array(z.string()).describe('Required: one or more terms; fuzzy match on token **name**, **description**, **exampleValue**, **usageGuidelines.usage**, and **usageGuidelines.cssProperties**. Example: `["spacing", "color.text", "background"]`.'),
   limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional(),
-  includeMetadata: z.boolean().default(false).describe('Include usage guidelines in each result (default false).').optional()
+  includeMetadata: z.boolean().default(false).describe('Include the token description and usage guidelines in each result (default false).').optional()
 });

package/dist/esm/tools/search-tokens/search-tokens-tool.js

@@ -71,6 +71,7 @@ export var searchTokensTool = /*#__PURE__*/function () {
               name: item.name,
               exampleValue: item.exampleValue
             }, includeMetadata ? {
+              description: item.description,
               usageGuidelines: item.usageGuidelines
             } : {});
           });

package/dist/types/tools/get-atlaskit-components/atlaskit-components.codegen.d.ts

@@ -3,7 +3,7 @@
  *
  * Structured content components from *.docs.tsx files outside of design-system
  *
- * @codegen <<SignedSource::35013a8fe45c8b5f501ae712dbba3d5f>>
+ * @codegen <<SignedSource::0e042569161f64ca963faec2ca7cc689>>
  * @codegenCommand afm workspace @af/ads-ai-tooling codegen
  */
 import type { ComponentMcpPayload } from '../get-all-components/types';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/ads-mcp",
-	"version": "1.10.11",
+	"version": "1.11.0",
 	"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",
@@ -14,7 +14,7 @@
 	"repository": "https://bitbucket.org/atlassian/atlassian-frontend-mirror",
 	"scripts": {
 		"ak-postbuild": "afm workspace @atlassian/structured-docs build",
-		"prepare": "yarn ak-postbuild"
+		"prepare": "afm run ak-postbuild"
 	},
 	"bin": "index.js",
 	"main": "dist/cjs/index.js",
@@ -24,7 +24,7 @@
 		"@atlaskit/icon": "^38.0.0",
 		"@atlaskit/icon-lab": "^7.11.0",
 		"@atlaskit/platform-feature-flags": "^2.2.0",
-		"@atlaskit/tokens": "^20.3.0",
+		"@atlaskit/tokens": "^20.4.0",
 		"@axe-core/playwright": "^4.11.1",
 		"@axe-core/puppeteer": "^4.11.1",
 		"@babel/runtime": "^7.0.0",