Tool names below show the bare catalog/CLI form. MCP
tools/calladds thefmt_capability prefix (v3.0.0+) — e.g.fmt_tap_widget,fmt_hot_reload_and_capture. CLIflutter-mcp-toolkit exec --name <bare>uses the unprefixed form.
| Feature | Why It Is Useful | Learn More |
|---|---|---|
App error retrieval (get_app_errors) |
Gives condensed runtime errors for faster fixes | CLI quick recipes |
Screenshots (get_screenshots) |
Lets AI see current UI state | CLI quick recipes |
View details (get_view_details) |
Exposes view metadata and widget-tree inspection payloads | CLI quick recipes |
Target discovery (discover_debug_apps) |
Returns canonical websocket target URIs for reliable multi-app selection | CLI quick recipes |
Unified evidence (capture_ui_snapshot) |
Captures screenshot/layout/error data in a single debugging bundle | CLI quick recipes |
Coordinate inspection (inspect_widget_at_point) |
Maps visual coordinates back to widget/render nodes and source hints | 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, Interaction cookbook |
Fused edit/preview (hot_reload_and_capture) |
Single round-trip: hot reload, screenshot, fresh semantic snapshot, and errors | CLI quick recipes |
Runtime introspection (evaluate_dart_expression, get_recent_logs) |
Read app state and recent logs without pre-registered tools | CLI quick recipes |
| Hot reload / hot restart | Fast iteration from assistant commands | CLI quick recipes |
| Dynamic tool registry | Register project-specific tools at runtime | Dynamic tool registry |
| Connection targeting | Reliable tool execution with multiple debug targets | MCP configuration |
| CLI + MCP dual interface | Use terminal automation and assistant workflows with shared core behavior | CLI vs MCP |
| CLI command recipes | Copy-paste patterns for local and CI automation | CLI quick recipes |
- v2 → v3 wire-format changes (tool prefix, removed live-edit codes): v2 to v3 migration
- Human-first setup: Execution playbook
- Human client setup: Execution playbook
- Agent-first setup: AI agent execution playbook