@atlaskit/ads-mcp 1.7.4 → 1.8.1

package/dist/es2019/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 const listSearchTokensTool = {
   name: 'ads_search_tokens',
-  description: `Searches Atlassian Design System **design tokens** from bundled metadata. Returns JSON objects with **name** and **exampleValue** for each match (search also considers description, usage guidelines, and CSS property hints in metadata).
+  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.
 
 WHEN TO USE:
 **Styling or theming in code**—you need the right \`token('…')\` 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.

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

@@ -2,5 +2,6 @@
 import { z } from 'zod';
 export const 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()
+  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()
 });

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

@@ -6,7 +6,8 @@ import { mergeMultiTermFuseResults } from '../../helpers';
 import { cleanQuery } from '../../helpers/clean-query';
 export const searchTokensTool = async ({
   terms,
-  limit = 2
+  limit = 2,
+  includeMetadata = false
 }) => {
   // Unique cleaned terms (order preserved) so duplicates don't concatenate into a bogus query.
   const searchTerms = [...new Set(terms.filter(Boolean).map(cleanQuery))];
@@ -54,7 +55,10 @@ export const searchTokensTool = async ({
   });
   const matchedTokens = matchedItems.map(item => ({
     name: item.name,
-    exampleValue: item.exampleValue
+    exampleValue: item.exampleValue,
+    ...(includeMetadata ? {
+      usageGuidelines: item.usageGuidelines
+    } : {})
   }));
   if (!matchedTokens.length) {
     return {