@actioneer/ads-mcp 0.5.9 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actioneer/ads-mcp",
-  "version": "0.5.9",
+  "version": "0.7.0",
   "description": "ADS MCP server: lets an agent in Claude Code / Cursor discover and import the Actioneer Design System",
   "type": "module",
   "bin": {

package/src/tools.mjs

@@ -4,7 +4,14 @@
 // `call(name, args)` dispatcher, so the stdio server and node:test share one
 // code path (no MCP dependency needed to test the tools).
 
-import { searchComponents, getComponent, getToken, getPrinciples } from "@actioneer/ads-manifest/query";
+import {
+  searchComponents,
+  getComponent,
+  getToken,
+  getPrinciples,
+  getUiGrammar,
+  getDesignGraph,
+} from "@actioneer/ads-manifest/query";
 import { lintSnippet, formatVerdict } from "./lint.mjs";
 
 export function createTools({ manifest }) {
@@ -85,6 +92,36 @@ export function createTools({ manifest }) {
         required: ["code"],
       },
     },
+    {
+      name: "get_ui_grammar",
+      description:
+        "Get ADS's legal named-JSX composition trees. Query by exact production id or UI intent " +
+        "before authoring a screen or recipe. Returns exact component nesting, constraints, linked " +
+        "principles, representative JSX, and the rendered Storybook owner. With no filter, returns " +
+        "the compact production/state-model index.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: { type: "string", description: "Exact production id, e.g. 'data-table' or 'browse-with-detail'." },
+          intent: { type: "string", description: "UI intent, e.g. 'settings', 'records', or 'research'." },
+        },
+      },
+    },
+    {
+      name: "get_design_graph",
+      description:
+        "Get the executable ADS design graph. A production slice returns its component tree plus " +
+        "variant/interaction state nodes; a component slice returns its state axes and every grammar " +
+        "production that composes it. States are independent axes, not a Cartesian-product mandate.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          production: { type: "string", description: "Exact grammar production id." },
+          component: { type: "string", description: "Exact ADS component name." },
+          includeStates: { type: "boolean", description: "Include component state nodes (default true)." },
+        },
+      },
+    },
   ];
 
   const handlers = {
@@ -145,6 +182,45 @@ export function createTools({ manifest }) {
       const result = lintSnippet(args.code, { filename: args.filename });
       return text(formatVerdict(result));
     },
+
+    get_ui_grammar: (args) => {
+      const result = getUiGrammar(manifest, { id: args.id, intent: args.intent });
+      if (!result) {
+        const query = args.id ?? args.intent;
+        return text(
+          query
+            ? `No ADS UI grammar production matches "${query}". Call get_ui_grammar with no filters to list production ids.`
+            : "This ADS manifest does not contain a UI grammar.",
+          true,
+        );
+      }
+      if ((args.id || args.intent) && result.productions.length === 0) {
+        const query = args.id ?? args.intent;
+        return text(`No ADS UI grammar production matches "${query}". Call get_ui_grammar with no filters to list production ids.`, true);
+      }
+      return json(result);
+    },
+
+    get_design_graph: (args) => {
+      if (args.production && args.component) {
+        return text("Choose either production or component when querying the design graph, not both.", true);
+      }
+      const result = getDesignGraph(manifest, {
+        production: args.production,
+        component: args.component,
+        includeStates: args.includeStates ?? true,
+      });
+      if (!result) {
+        const target = args.production ?? args.component;
+        return text(
+          target
+            ? `No ADS design-graph node matches "${target}". Use exact production ids or component names.`
+            : "This ADS manifest does not contain a design graph.",
+          true,
+        );
+      }
+      return json(result);
+    },
   };
 
   return {