Search Flows
search_flowsSearch Mobbin for multi-step user flows (e.g. onboarding, checkout) using natural language. Returns evenly-spaced preview images inline along with metadata for each flow, including per-screen previews. Examine the returned images to understand each flow's actual content — do not describe screens based solely on metadata. On hosts that support MCP Apps, also renders an interactive gallery of the results.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for paginating through results. Maximum 20. | |
| limit | No | Maximum number of flows to return. Lower limits are recommended to manage context size. | |
| query | Yes | Describe one user journey in plain language — the steps and what you'd see along the way. Be specific; detail helps. Good: "onboarding with personalization steps", "checkout with payment method selection". Avoid: combining multiple flows (search separately), negations, vague style words, disconnected keyword lists. Name a specific app to filter results to it (e.g. "Duolingo onboarding"). Do not include platform (ios/web) — use the dedicated parameter. | |
| platform | Yes | Platform to search. | |
| task_intent | No | One short sentence summarizing the user's overall task. Helps return more relevant results. Write it in English even when the conversation is in another language. MUST be the same across all calls for the same task. Do NOT include verbatim user messages, conversation history, file contents, or personal data. | |
| image_format | No | Image format. Use jpg if your client does not support webp. | webp |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | 1-based page number of search results. | |
| flows | Yes | ||
| query | Yes | The natural language query used for this search. | |
| has_next_page | Yes | Whether more pages of results are available. |