# Flutter MCP Toolkit Documentation

Flutter MCP Toolkit connects a running Flutter debug app to AI assistants through MCP, so your assistant can inspect UI, read runtime errors, hot reload, and run app-defined tools.

## Choose Your Path

| Audience | Start Here |
| --- | --- |
| Human developer | [Execution playbook](/ai_agents/execution_playbook) |
| AI agent (Codex, Claude, Cursor, Cline, RooCode) | [AI agent overview](/ai_agents/overview) |
| CI / automation workflow | [CLI vs MCP](/start_here/cli_vs_mcp) |

## Why This Repo Matters

- Flutter-specific workflows: screenshots, app errors, view details, hot reload/restart.
- Dynamic tool registry: your app can register custom tools/resources at runtime.
- Better AI debugging loops: tools return structured data and retry guidance.
- Multi-target safety: explicit `connection.targetId` flow when multiple debug apps are running.

Read more in [Why this repo matters](/start_here/why_this_repo_matters).

## Feature Discovery

Use [Feature map](/start_here/feature_map) for a capabilities overview and where to learn each one.
Need a complete page-by-page index? [Docs map](/start_here/docs_map)

Need to decide between terminal automation and AI-client tool usage?
[CLI vs MCP](/start_here/cli_vs_mcp)

Need ready-to-run terminal commands?
[CLI quick recipes](/start_here/cli_quick_recipes)

## Video Walkthroughs

- [Dynamic Tools Registration (YouTube)](https://www.youtube.com/watch?v=Qog3x2VcO98)
- [Cursor Setup Walkthrough (YouTube)](https://www.youtube.com/watch?v=pyDHaI81uts)
- [All videos and watch order](/start_here/video_walkthroughs)

## Contributors And Community

- [Who contributed and how](/contributing/contributors)
- [How to contribute](/contributing/contribution_guide)