# Feature Map

> Tool names below show the bare catalog/CLI form. MCP `tools/call` adds the
> `fmt_` capability prefix (v3.0.0+) — e.g. `fmt_tap_widget`,
> `fmt_hot_reload_and_capture`. CLI `flutter-mcp-toolkit exec --name <bare>`
> uses the unprefixed form.

## Core Features

| Feature | Why It Is Useful | Learn More |
| --- | --- | --- |
| App error retrieval (`get_app_errors`) | Gives condensed runtime errors for faster fixes | [CLI quick recipes](/start_here/cli_quick_recipes) |
| Screenshots (`get_screenshots`) | Lets AI see current UI state | [CLI quick recipes](/start_here/cli_quick_recipes) |
| View details (`get_view_details`) | Exposes view metadata and widget-tree inspection payloads | [CLI quick recipes](/start_here/cli_quick_recipes) |
| Target discovery (`discover_debug_apps`) | Returns canonical websocket target URIs for reliable multi-app selection | [CLI quick recipes](/start_here/cli_quick_recipes) |
| Unified evidence (`capture_ui_snapshot`) | Captures screenshot/layout/error data in a single debugging bundle | [CLI quick recipes](/start_here/cli_quick_recipes) |
| Coordinate inspection (`inspect_widget_at_point`) | Maps visual coordinates back to widget/render nodes and source hints | [CLI quick recipes](/start_here/cli_quick_recipes) |
| Interaction layer (`semantic_snapshot` + `tap_widget` / `enter_text` / `reveal_search` / `scroll` / `swipe` / `long_press` / `drag`) | Lets an agent drive the running app like a user (Playwright-style refs, bounded off-screen reveal, two-tier semantic-action → pointer-event dispatch) | [CLI quick recipes](/start_here/cli_quick_recipes), [Interaction cookbook](/guides/interaction_cookbook) |
| Fused edit/preview (`hot_reload_and_capture`) | Single round-trip: hot reload, screenshot, fresh semantic snapshot, and errors | [CLI quick recipes](/start_here/cli_quick_recipes) |
| Runtime introspection (`evaluate_dart_expression`, `get_recent_logs`) | Read app state and recent logs without pre-registered tools | [CLI quick recipes](/start_here/cli_quick_recipes) |
| Hot reload / hot restart | Fast iteration from assistant commands | [CLI quick recipes](/start_here/cli_quick_recipes) |
| Dynamic tool registry | Register project-specific tools at runtime | [Dynamic tool registry](/core/dynamic_tools_registry) |
| Connection targeting | Reliable tool execution with multiple debug targets | [MCP configuration](/core/mcp_configuration) |
| CLI + MCP dual interface | Use terminal automation and assistant workflows with shared core behavior | [CLI vs MCP](/start_here/cli_vs_mcp) |
| CLI command recipes | Copy-paste patterns for local and CI automation | [CLI quick recipes](/start_here/cli_quick_recipes) |

## Migrating

- v2 → v3 wire-format changes (tool prefix, removed live-edit codes): [v2 to v3 migration](/start_here/migration_v2_to_v3)

## Installation Paths

- Human-first setup: [Execution playbook](/ai_agents/execution_playbook)
- Human client setup: [Execution playbook](/ai_agents/execution_playbook)
- Agent-first setup: [AI agent execution playbook](/ai_agents/execution_playbook)

## Video Support

- [Dynamic tools demo (YouTube)](https://www.youtube.com/watch?v=Qog3x2VcO98)
- [Cursor setup demo (YouTube)](https://www.youtube.com/watch?v=pyDHaI81uts)
