@ingenx-io/valets-schema-mcp-server 0.2.3 → 0.2.5

package/index.js

@@ -19,6 +19,7 @@
  *   - list_decisions     → all data model decisions with status
  *   - get_decision       → single decision detail
  *   - get_openapi        → OpenAPI 3.1 spec (full or single component)
+ *   - get_guidance       → use-case recipes (call sequences, field cheatsheets, workaround notes)
  *
  * Resources:
  *   - valets://schemas.json    → full schema bundle
@@ -103,6 +104,11 @@ async function loadOpenapi() {
   return fetchOrRead("/openapi.yaml", join(BUNDLED_STATIC, "openapi.yaml"));
 }
 
+async function loadCookbook() {
+  const raw = await fetchOrRead("/cookbook.json", join(BUNDLED_STATIC, "cookbook.json"));
+  return JSON.parse(raw);
+}
+
 // ---------------------------------------------------------------------------
 // Doc page loading (Markdown)
 // ---------------------------------------------------------------------------
@@ -319,6 +325,32 @@ server.tool(
   }
 );
 
+server.tool(
+  "get_guidance",
+  "Get use-case recipes showing which MCP tools to call and in what order. Call with no arguments for an index of all recipes, or pass a slug to get the full recipe detail.",
+  { slug: z.string().optional().describe("Recipe slug (e.g. 'write-model-code', 'field-history', 'whatsapp-conversation-display'). Omit to list all recipes.") },
+  async ({ slug } = {}) => {
+    const cookbook = await loadCookbook();
+    if (!slug) {
+      const index = cookbook.recipes.map((r) => `- **${r.slug}**: ${r.summary}`).join("\n");
+      return {
+        content: [{ type: "text", text: `Available recipes (${cookbook.recipes.length}):\n\n${index}\n\nCall get_guidance with a slug to get the full recipe.` }],
+      };
+    }
+    const recipe = cookbook.recipes.find((r) => r.slug === slug);
+    if (!recipe) {
+      const available = cookbook.recipes.map((r) => r.slug);
+      return {
+        content: [{ type: "text", text: `Recipe "${slug}" not found.\n\nAvailable slugs:\n${available.map((s) => `  - ${s}`).join("\n")}` }],
+        isError: true,
+      };
+    }
+    return {
+      content: [{ type: "text", text: JSON.stringify(recipe, null, 2) }],
+    };
+  }
+);
+
 // ---------------------------------------------------------------------------
 // Resources
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingenx-io/valets-schema-mcp-server",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "MCP server exposing @valets/schema documentation to AI agents",
   "type": "module",
   "main": "index.js",