@flowdot.ai/mcp-server 1.0.1 → 1.0.2

package/dist/tools/delete-recipe.d.ts

@@ -0,0 +1,13 @@
+/**
+ * delete_recipe MCP Tool
+ *
+ * Permanently deletes an agent recipe.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const deleteRecipeTool: Tool;
+export declare function handleDeleteRecipe(api: FlowDotApiClient, args: {
+    hash: string;
+    confirm: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=delete-recipe.d.ts.map

package/dist/tools/delete-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-recipe.d.ts","sourceRoot":"","sources":["../../src/tools/delete-recipe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,gBAAgB,EAAE,IAiB9B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACvC,OAAO,CAAC,cAAc,CAAC,CAmCzB"}

package/dist/tools/delete-recipe.js

@@ -0,0 +1,59 @@
+/**
+ * delete_recipe MCP Tool
+ *
+ * Permanently deletes an agent recipe.
+ */
+export const deleteRecipeTool = {
+    name: 'delete_recipe',
+    description: 'Permanently delete an agent recipe. This action cannot be undone.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            hash: {
+                type: 'string',
+                description: 'The recipe hash/ID to delete',
+            },
+            confirm: {
+                type: 'boolean',
+                description: 'Must be true to confirm deletion',
+            },
+        },
+        required: ['hash', 'confirm'],
+    },
+};
+export async function handleDeleteRecipe(api, args) {
+    try {
+        if (!args.confirm) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Deletion cancelled. Set confirm to true to delete the recipe.',
+                    },
+                ],
+            };
+        }
+        await api.deleteRecipe(args.hash);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Recipe ${args.hash} has been permanently deleted.`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error deleting recipe: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=delete-recipe.js.map

package/dist/tools/delete-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-recipe.js","sourceRoot":"","sources":["../../src/tools/delete-recipe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,mEAAmE;IAChF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,kCAAkC;aAChD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;KAC9B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAqB,EACrB,IAAwC;IAExC,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,+DAA+D;qBACtE;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,UAAU,IAAI,CAAC,IAAI,gCAAgC;iBAC1D;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,0BAA0B,OAAO,EAAE;iBAC1C;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/favorite-recipe.d.ts

@@ -0,0 +1,13 @@
+/**
+ * favorite_recipe MCP Tool
+ *
+ * Add or remove a recipe from favorites.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const favoriteRecipeTool: Tool;
+export declare function handleFavoriteRecipe(api: FlowDotApiClient, args: {
+    hash: string;
+    favorite: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=favorite-recipe.d.ts.map

package/dist/tools/favorite-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"favorite-recipe.d.ts","sourceRoot":"","sources":["../../src/tools/favorite-recipe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,kBAAkB,EAAE,IAiBhC,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GACxC,OAAO,CAAC,cAAc,CAAC,CA6BzB"}

package/dist/tools/favorite-recipe.js

@@ -0,0 +1,53 @@
+/**
+ * favorite_recipe MCP Tool
+ *
+ * Add or remove a recipe from favorites.
+ */
+export const favoriteRecipeTool = {
+    name: 'favorite_recipe',
+    description: 'Add or remove a recipe from your favorites. Favorited recipes can be filtered in list_recipes.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            hash: {
+                type: 'string',
+                description: 'The recipe hash/ID',
+            },
+            favorite: {
+                type: 'boolean',
+                description: 'Set to true to add to favorites, false to remove',
+            },
+        },
+        required: ['hash', 'favorite'],
+    },
+};
+export async function handleFavoriteRecipe(api, args) {
+    try {
+        const result = await api.favoriteRecipe(args.hash, args.favorite);
+        const emoji = args.favorite ? '⭐' : '✓';
+        const action = args.favorite ? 'added to' : 'removed from';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `${emoji} Recipe ${action} favorites!
+
+**Favorited:** ${result.is_favorited ? 'Yes' : 'No'}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error updating favorite: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=favorite-recipe.js.map

package/dist/tools/favorite-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"favorite-recipe.js","sourceRoot":"","sources":["../../src/tools/favorite-recipe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,gGAAgG;IAC7G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oBAAoB;aAClC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,kDAAkD;aAChE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;KAC/B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAqB,EACrB,IAAyC;IAEzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAElE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC;QAE3D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,GAAG,KAAK,WAAW,MAAM;;iBAExB,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;iBAC5C;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,4BAA4B,OAAO,EAAE;iBAC5C;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/fork-recipe.d.ts

@@ -0,0 +1,13 @@
+/**
+ * fork_recipe MCP Tool
+ *
+ * Creates a copy of a public recipe.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const forkRecipeTool: Tool;
+export declare function handleForkRecipe(api: FlowDotApiClient, args: {
+    hash: string;
+    name?: string;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=fork-recipe.d.ts.map

package/dist/tools/fork-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-recipe.d.ts","sourceRoot":"","sources":["../../src/tools/fork-recipe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,cAAc,EAAE,IAiB5B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,OAAO,CAAC,cAAc,CAAC,CA+BzB"}

package/dist/tools/fork-recipe.js

@@ -0,0 +1,56 @@
+/**
+ * fork_recipe MCP Tool
+ *
+ * Creates a copy of a public recipe.
+ */
+export const forkRecipeTool = {
+    name: 'fork_recipe',
+    description: 'Create a copy of a public recipe into your account. The copy will be private and editable.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            hash: {
+                type: 'string',
+                description: 'The recipe hash/ID to fork',
+            },
+            name: {
+                type: 'string',
+                description: 'Optional new name for the forked recipe',
+            },
+        },
+        required: ['hash'],
+    },
+};
+export async function handleForkRecipe(api, args) {
+    try {
+        const result = await api.forkRecipe(args.hash, args.name);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Recipe forked successfully!
+
+**New Name:** ${result.name}
+**New Hash:** ${result.hash}
+**Forked From:** ${result.forked_from.name} by ${result.forked_from.user_name}
+**Visibility:** Private
+
+You can now edit this recipe and customize it for your needs.`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error forking recipe: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=fork-recipe.js.map

package/dist/tools/fork-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-recipe.js","sourceRoot":"","sources":["../../src/tools/fork-recipe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,4FAA4F;IACzG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAqB,EACrB,IAAqC;IAErC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEA,MAAM,CAAC,IAAI;gBACX,MAAM,CAAC,IAAI;mBACR,MAAM,CAAC,WAAW,CAAC,IAAI,OAAO,MAAM,CAAC,WAAW,CAAC,SAAS;;;8DAGf;iBACrD;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,yBAAyB,OAAO,EAAE;iBACzC;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/get-recipe-definition.d.ts

@@ -0,0 +1,15 @@
+/**
+ * get_recipe_definition MCP Tool
+ *
+ * Gets the complete recipe definition in YAML format for export or inspection.
+ * This is the canonical format for recipe definitions - both MCP and CLI
+ * should return identical YAML output for validation purposes.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const getRecipeDefinitionTool: Tool;
+export declare function handleGetRecipeDefinition(api: FlowDotApiClient, args: {
+    hash: string;
+    format?: 'yaml' | 'json';
+}): Promise<CallToolResult>;
+//# sourceMappingURL=get-recipe-definition.d.ts.map

package/dist/tools/get-recipe-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-recipe-definition.d.ts","sourceRoot":"","sources":["../../src/tools/get-recipe-definition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,eAAO,MAAM,uBAAuB,EAAE,IAmBrC,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,cAAc,CAAC,CA0CzB"}

package/dist/tools/get-recipe-definition.js

@@ -0,0 +1,70 @@
+/**
+ * get_recipe_definition MCP Tool
+ *
+ * Gets the complete recipe definition in YAML format for export or inspection.
+ * This is the canonical format for recipe definitions - both MCP and CLI
+ * should return identical YAML output for validation purposes.
+ */
+import yaml from 'js-yaml';
+export const getRecipeDefinitionTool = {
+    name: 'get_recipe_definition',
+    description: 'Get the complete recipe definition in YAML format. Returns all steps, stores, entry_step_id, and configuration details. Use this to inspect or validate recipe definitions.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            hash: {
+                type: 'string',
+                description: 'The recipe hash/ID',
+            },
+            format: {
+                type: 'string',
+                enum: ['yaml', 'json'],
+                description: 'Output format: yaml (default) or json',
+            },
+        },
+        required: ['hash'],
+    },
+};
+export async function handleGetRecipeDefinition(api, args) {
+    try {
+        const definition = await api.getRecipeDefinition(args.hash);
+        const format = args.format || 'yaml';
+        let text;
+        let codeBlock;
+        if (format === 'json') {
+            text = JSON.stringify(definition, null, 2);
+            codeBlock = 'json';
+        }
+        else {
+            // YAML output - canonical format for recipe definitions
+            text = yaml.dump(definition, {
+                indent: 2,
+                lineWidth: 120,
+                noRefs: true,
+                sortKeys: false, // Preserve field order
+            });
+            codeBlock = 'yaml';
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Recipe Definition for ${args.hash}:\n\n\`\`\`${codeBlock}\n${text}\`\`\``,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error getting recipe definition: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=get-recipe-definition.js.map

package/dist/tools/get-recipe-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-recipe-definition.js","sourceRoot":"","sources":["../../src/tools/get-recipe-definition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,MAAM,CAAC,MAAM,uBAAuB,GAAS;IAC3C,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,6KAA6K;IAC/K,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oBAAoB;aAClC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;gBACtB,WAAW,EAAE,uCAAuC;aACrD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,GAAqB,EACrB,IAAgD;IAEhD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;QAErC,IAAI,IAAY,CAAC;QACjB,IAAI,SAAiB,CAAC;QAEtB,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3C,SAAS,GAAG,MAAM,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;gBAC3B,MAAM,EAAE,CAAC;gBACT,SAAS,EAAE,GAAG;gBACd,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,KAAK,EAAE,uBAAuB;aACzC,CAAC,CAAC;YACH,SAAS,GAAG,MAAM,CAAC;QACrB,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,yBAAyB,IAAI,CAAC,IAAI,cAAc,SAAS,KAAK,IAAI,QAAQ;iBACjF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,oCAAoC,OAAO,EAAE;iBACpD;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/get-recipe.d.ts

@@ -0,0 +1,12 @@
+/**
+ * get_recipe MCP Tool
+ *
+ * Gets detailed information about a specific agent recipe.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const getRecipeTool: Tool;
+export declare function handleGetRecipe(api: FlowDotApiClient, args: {
+    hash: string;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=get-recipe.d.ts.map

package/dist/tools/get-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-recipe.d.ts","sourceRoot":"","sources":["../../src/tools/get-recipe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,aAAa,EAAE,IAc3B,CAAC;AAEF,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GACrB,OAAO,CAAC,cAAc,CAAC,CA0EzB"}

package/dist/tools/get-recipe.js

@@ -0,0 +1,88 @@
+/**
+ * get_recipe MCP Tool
+ *
+ * Gets detailed information about a specific agent recipe.
+ */
+export const getRecipeTool = {
+    name: 'get_recipe',
+    description: 'Get detailed information about a specific agent recipe including its steps, stores, and metadata.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            hash: {
+                type: 'string',
+                description: 'The recipe hash/ID',
+            },
+        },
+        required: ['hash'],
+    },
+};
+export async function handleGetRecipe(api, args) {
+    try {
+        const recipe = await api.getRecipe(args.hash);
+        // Format step types count
+        const stepTypes = {};
+        if (recipe.steps) {
+            recipe.steps.forEach((s) => {
+                stepTypes[s.type] = (stepTypes[s.type] || 0) + 1;
+            });
+        }
+        const stepTypesStr = Object.entries(stepTypes)
+            .map(([type, count]) => `${type}: ${count}`)
+            .join(', ');
+        // Format stores
+        const inputStores = recipe.stores?.filter((s) => s.is_input) || [];
+        const outputStores = recipe.stores?.filter((s) => s.is_output) || [];
+        let storeInfo = '';
+        if (inputStores.length > 0) {
+            storeInfo += `\n\n**Input Stores (${inputStores.length}):**\n`;
+            storeInfo += inputStores.map((s) => `- ${s.key}: ${s.schema_type}${s.description ? ` - ${s.description}` : ''}`).join('\n');
+        }
+        if (outputStores.length > 0) {
+            storeInfo += `\n\n**Output Stores (${outputStores.length}):**\n`;
+            storeInfo += outputStores.map((s) => `- ${s.key}: ${s.schema_type}${s.description ? ` - ${s.description}` : ''}`).join('\n');
+        }
+        // Format steps summary
+        let stepsInfo = '';
+        if (recipe.steps && recipe.steps.length > 0) {
+            stepsInfo = `\n\n**Steps (${recipe.steps.length}):**\n`;
+            stepsInfo += recipe.steps.map((s) => {
+                const entryMark = s.id === recipe.entry_step_id ? ' [ENTRY]' : '';
+                return `- ${s.name} (${s.type})${entryMark}${s.description ? `: ${s.description}` : ''}`;
+            }).join('\n');
+        }
+        const visibility = recipe.visibility === 'public' ? 'Public' : recipe.visibility === 'unlisted' ? 'Unlisted' : 'Private';
+        const text = `# ${recipe.name}
+
+**Hash:** ${recipe.hash}
+**Version:** ${recipe.version}
+**Visibility:** ${visibility}
+**Category:** ${recipe.category || 'None'}
+**Tags:** ${recipe.tags?.length ? recipe.tags.join(', ') : 'None'}
+
+**Description:** ${recipe.description || 'No description'}
+
+**Step Types:** ${stepTypesStr || 'No steps'}${storeInfo}${stepsInfo}`;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error getting recipe: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=get-recipe.js.map

package/dist/tools/get-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-recipe.js","sourceRoot":"","sources":["../../src/tools/get-recipe.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAsWpD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAypBzE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAmZpD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CA4xBzE"}

package/dist/tools/index.js

@@ -152,6 +152,29 @@ import { getKnowledgeStorageToolDef, handleGetKnowledgeStorage } from './get-kno
 // Agent Toolkit Tools (agent_toolkits:read / agent_toolkits:manage)
 // ============================================
 import { listAgentToolkitsTool, handleListAgentToolkits, searchAgentToolkitsTool, handleSearchAgentToolkits, getAgentToolkitTool, handleGetAgentToolkit, getToolkitCommentsTool, handleGetToolkitComments, createAgentToolkitTool, handleCreateAgentToolkit, updateAgentToolkitTool, handleUpdateAgentToolkit, deleteAgentToolkitTool, handleDeleteAgentToolkit, copyAgentToolkitTool, handleCopyAgentToolkit, toggleToolkitVisibilityTool, handleToggleToolkitVisibility, voteToolkitTool, handleVoteToolkit, favoriteToolkitTool, handleFavoriteToolkit, addToolkitCommentTool, handleAddToolkitComment, installToolkitTool, handleInstallToolkit, uninstallToolkitTool, handleUninstallToolkit, listInstalledToolkitsTool, handleListInstalledToolkits, toggleToolkitActiveTool, handleToggleToolkitActive, checkToolkitCredentialsTool, handleCheckToolkitCredentials, updateToolkitInstallationTool, handleUpdateToolkitInstallation, invokeToolkitToolTool, handleInvokeToolkitTool, listToolkitToolsTool, handleListToolkitTools, getToolkitToolTool, handleGetToolkitTool, createToolkitToolTool, handleCreateToolkitTool, updateToolkitToolTool, handleUpdateToolkitTool, deleteToolkitToolTool, handleDeleteToolkitTool, } from './agent-toolkits.js';
+// ============================================
+// Agent Recipe Tools (recipes:read / recipes:manage)
+// ============================================
+import { listRecipesTool, handleListRecipes } from './list-recipes.js';
+import { getRecipeTool, handleGetRecipe } from './get-recipe.js';
+import { getRecipeDefinitionTool, handleGetRecipeDefinition } from './get-recipe-definition.js';
+import { browseRecipesTool, handleBrowseRecipes } from './browse-recipes.js';
+import { createRecipeTool, handleCreateRecipe } from './create-recipe.js';
+import { updateRecipeTool, handleUpdateRecipe } from './update-recipe.js';
+import { deleteRecipeTool, handleDeleteRecipe } from './delete-recipe.js';
+import { forkRecipeTool, handleForkRecipe } from './fork-recipe.js';
+// REMOVED: execute_recipe and get_recipe_execution - MCP CANNOT run recipes, only CLI can
+import { listRecipeStepsTool, handleListRecipeSteps } from './list-recipe-steps.js';
+import { addRecipeStepTool, handleAddRecipeStep } from './add-recipe-step.js';
+import { updateRecipeStepTool, handleUpdateRecipeStep } from './update-recipe-step.js';
+import { deleteRecipeStepTool, handleDeleteRecipeStep } from './delete-recipe-step.js';
+import { listRecipeStoresTool, handleListRecipeStores } from './list-recipe-stores.js';
+import { addRecipeStoreTool, handleAddRecipeStore } from './add-recipe-store.js';
+import { updateRecipeStoreTool, handleUpdateRecipeStore } from './update-recipe-store.js';
+import { deleteRecipeStoreTool, handleDeleteRecipeStore } from './delete-recipe-store.js';
+import { voteRecipeTool, handleVoteRecipe } from './vote-recipe.js';
+import { favoriteRecipeTool, handleFavoriteRecipe } from './favorite-recipe.js';
+import { linkRecipeTool, handleLinkRecipe } from './link-recipe.js';
 // All available tools
 const tools = [
     // Core (4)
@@ -294,6 +317,27 @@ const tools = [
     createToolkitToolTool,
     updateToolkitToolTool,
     deleteToolkitToolTool,
+    // Agent Recipes (21)
+    listRecipesTool,
+    getRecipeTool,
+    getRecipeDefinitionTool,
+    browseRecipesTool,
+    createRecipeTool,
+    updateRecipeTool,
+    deleteRecipeTool,
+    forkRecipeTool,
+    // REMOVED: executeRecipeTool, getRecipeExecutionTool - MCP CANNOT run recipes
+    listRecipeStepsTool,
+    addRecipeStepTool,
+    updateRecipeStepTool,
+    deleteRecipeStepTool,
+    listRecipeStoresTool,
+    addRecipeStoreTool,
+    updateRecipeStoreTool,
+    deleteRecipeStoreTool,
+    voteRecipeTool,
+    favoriteRecipeTool,
+    linkRecipeTool,
 ];
 /**
  * Register all tools with the MCP server.
@@ -604,6 +648,49 @@ export function registerTools(server, api) {
                 return handleUpdateToolkitTool(api, args);
             case 'mcp__flowdot__delete_toolkit_tool':
                 return handleDeleteToolkitTool(api, args);
+            // ============================================
+            // Agent Recipe Tools
+            // ============================================
+            case 'list_recipes':
+                return handleListRecipes(api, args);
+            case 'get_recipe':
+                return handleGetRecipe(api, args);
+            case 'get_recipe_definition':
+                return handleGetRecipeDefinition(api, args);
+            case 'browse_recipes':
+                return handleBrowseRecipes(api, args);
+            case 'create_recipe':
+                return handleCreateRecipe(api, args);
+            case 'update_recipe':
+                return handleUpdateRecipe(api, args);
+            case 'delete_recipe':
+                return handleDeleteRecipe(api, args);
+            case 'fork_recipe':
+                return handleForkRecipe(api, args);
+            // REMOVED: execute_recipe and get_recipe_execution cases
+            // MCP CANNOT run recipes - only the CLI can enter recipe modes
+            case 'list_recipe_steps':
+                return handleListRecipeSteps(api, args);
+            case 'add_recipe_step':
+                return handleAddRecipeStep(api, args);
+            case 'update_recipe_step':
+                return handleUpdateRecipeStep(api, args);
+            case 'delete_recipe_step':
+                return handleDeleteRecipeStep(api, args);
+            case 'list_recipe_stores':
+                return handleListRecipeStores(api, args);
+            case 'add_recipe_store':
+                return handleAddRecipeStore(api, args);
+            case 'update_recipe_store':
+                return handleUpdateRecipeStore(api, args);
+            case 'delete_recipe_store':
+                return handleDeleteRecipeStore(api, args);
+            case 'vote_recipe':
+                return handleVoteRecipe(api, args);
+            case 'favorite_recipe':
+                return handleFavoriteRecipe(api, args);
+            case 'link_recipe':
+                return handleLinkRecipe(api, args);
             default:
                 return {
                     content: [