--- title: "list_recipes: List recipes" description: "Search and page through the RECIPE catalog — templates that ask you questions and then make something." canonical_url: "https://meetkuro.com/agents/tools/list_recipes/" updated: 2026-11-03 locale: "en" tool: "list_recipes" scopes: ["recipes.read"] --- # list_recipes **List recipes** Search and page through the RECIPE catalog — templates that ask you questions and then make something. Search it before choosing a model. A recipe arms ONE generation (arm: a private template; reprompt: a model writes the prompt from your answers; press either with generate_with_recipe) or runs a multi-step workflow (run: start_recipe_run). One recipe per generation; filter by model_id only when the user chose a model. Narrow by `model_kind` (image or video). For STYLES — rendering-medium fragments you arm directly on generate_image / generate_clip — use `list_presets`. ## Scope - `recipes.read` — Reads the public catalog and the account's own recipes. ## Behaviour - **Read-only**: Reads the caller's own account and changes nothing. - **Stays in the account**: Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else. - **Idempotent**: Calling it again with the same arguments has no further effect. ## Inputs | Name | Type | Required | Details | | --- | --- | --- | --- | | `model_kind` | string | no | one of "image", "video" | | `model_id` | string | no | one of "seedream-5-lite", "nano-banana-2.1", "nano-banana-2", "gpt-image-2.5-flare", "gpt-image-2.5-sunburst", "gpt-image-2", "nano-banana-2-lite", "seedream-5-pro", "flux-schnell", "flux-2-flex", "flux-2-pro", "flux-2-max", "recraft-v4.1-svg", "recraft-v4.1-pro-svg", "p-image", "grok-imagine-image", "grok-imagine-image-quality", "krea-3", "qwen-image-3-pro", "soul-2", "seedance-2.5", "seedance-2.0", "seedance-2.0-fast", "seedance-2.0-mini", "grok-imagine-video-1.5", "veo-3.1", "veo-3.1-fast", "veo-3.1-lite", "gemini-omni-1.1", "kling-v3-omni-video", "kling-v3-video", "happyhorse-1.0", "wan-3", "wan-3-prime", "gen-4.5", "p-video", "p-video-2", "flux-3", "minimax-h3-max", "p-video-avatar", "p-video-animate", "p-video-replace", "omni-human-1.5", "kling-avatar-v2", "kling-v3-motion-control", "sync-lipsync-2", "kling-lip-sync", "genjutsu-motion-transfer", "genjutsu-object-swap" | | `tags` | array of string | no | at most 4 items | | `line` | string | no | at most 40 characters | | `q` | string | no | at most 100 characters | | `cursor` | string | no | at most 500 characters | | `limit` | integer | no | ≥ 1; ≤ 50 | ## Example call A `tools/call` request with the required arguments only, each a placeholder read off the schema. Replace them before sending. ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "list_recipes", "arguments": {} } } ``` ## Input schema As the server sends it in `tools/list`: ```json { "type": "object", "properties": { "model_kind": { "type": "string", "enum": [ "image", "video" ] }, "model_id": { "type": "string", "enum": [ "seedream-5-lite", "nano-banana-2.1", "nano-banana-2", "gpt-image-2.5-flare", "gpt-image-2.5-sunburst", "gpt-image-2", "nano-banana-2-lite", "seedream-5-pro", "flux-schnell", "flux-2-flex", "flux-2-pro", "flux-2-max", "recraft-v4.1-svg", "recraft-v4.1-pro-svg", "p-image", "grok-imagine-image", "grok-imagine-image-quality", "krea-3", "qwen-image-3-pro", "soul-2", "seedance-2.5", "seedance-2.0", "seedance-2.0-fast", "seedance-2.0-mini", "grok-imagine-video-1.5", "veo-3.1", "veo-3.1-fast", "veo-3.1-lite", "gemini-omni-1.1", "kling-v3-omni-video", "kling-v3-video", "happyhorse-1.0", "wan-3", "wan-3-prime", "gen-4.5", "p-video", "p-video-2", "flux-3", "minimax-h3-max", "p-video-avatar", "p-video-animate", "p-video-replace", "omni-human-1.5", "kling-avatar-v2", "kling-v3-motion-control", "sync-lipsync-2", "kling-lip-sync", "genjutsu-motion-transfer", "genjutsu-object-swap" ] }, "tags": { "type": "array", "items": { "type": "string", "maxLength": 40 }, "maxItems": 4 }, "line": { "type": "string", "maxLength": 40 }, "q": { "type": "string", "maxLength": 100 }, "cursor": { "type": "string", "maxLength": 500 }, "limit": { "type": "integer", "minimum": 1, "maximum": 50 } }, "additionalProperties": false } ``` ## Related tools - [`generate_with_recipe`](https://meetkuro.com/agents/tools/generate_with_recipe.md): Create one image or clip with a guided recipe — an arm or reprompt recipe. - [`start_recipe_run`](https://meetkuro.com/agents/tools/start_recipe_run.md): Quote or start a workflow recipe. - [`generate_image`](https://meetkuro.com/agents/tools/generate_image.md): Make an image in the user's Kuro account. - [`generate_clip`](https://meetkuro.com/agents/tools/generate_clip.md): Start a short video clip generation. - [`list_presets`](https://meetkuro.com/agents/tools/list_presets.md): Search and page through Style, Motion, Lighting and Framing presets. - [`animate_image`](https://meetkuro.com/agents/tools/animate_image.md): Animate an existing image or upload into a clip. - [`list_own_recipes`](https://meetkuro.com/agents/tools/list_own_recipes.md): Page through the recipes you authored, saved or remixed — your private shelf, which list_recipes never shows. --- ## About Kuro Kuro is an AI picture studio: prompt-driven images, clips, voice-overs and music, and storyboard-backed films with consistent characters across every scene. Agents connect over MCP and can generate directly: ``` claude mcp add kuro https://api.meetkuro.com/mcp --transport http ``` The app is at https://app.meetkuro.com and requires an account. Each guide, model page, comparison and free tool page on this site (not a tool's variants, and not the index pages) has a Markdown twin at its own URL plus `.md`, and so do /benchmarks/, the English /agents/ page (as /agents.md) and the MCP tool reference. Every tool: https://meetkuro.com/agents/tools/