Feature Map
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.
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 |
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 / scroll / swipe / long_press / drag) | Lets an agent drive the running app like a user (Playwright-style refs, 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 |
Migrating
- v2 → v3 wire-format changes (tool prefix, removed live-edit codes): v2 to v3 migration
Installation Paths
- Human-first setup: Execution playbook
- Human client setup: Execution playbook
- Agent-first setup: AI agent execution playbook