flutter-mcp-toolkit
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/arenukvern--mcp-flutter)HTML
<a href="/listings/arenukvern--mcp-flutter"><img src="/api/listings/arenukvern--mcp-flutter/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
**1. Marketplace (recommended)** — see [client setup](docs/install/clients.mdx):
Claude Code: /plugin marketplace add Arenukvern/mcp_flutter
/plugin install flutter-mcp-toolkit@flutter-mcp-toolkit
Cursor: flutter-mcp-toolkit init cursor # needs CLI on PATH — install script first
Codex: codex plugin marketplace add Arenukvern/mcp_flutter**2. Install script (recommended for server + CLI on PATH)** — curl:
`curl -fsSL https://raw.githubusercontent.com/Arenukvern/mcp_flutter/main/install.sh | bash`
**3. Instrument the app** — `cd my_flutter_app && flutter-mcp-toolkit codegen-init` (paste `main()` snippet before `runApp`).
**4. Run and verify** — `flutter run --debug` then `flutter-mcp-toolkit doctor`.
Connect the MCP server in your host (`flutter-mcp-toolkit-server` on stdio). Example for Claude Code:
claude mcp add flutter-mcp-toolkit -- flutter-mcp-toolkit-server
First agent prompt: *“Discover debug Flutter apps, connect, and return a semantic snapshot.”*
Full steps: [docs/quickstart.mdx](docs/quickstart.mdx).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 30 lines
- {
- "name": "flutter-mcp-toolkit",
- "owner": {
- "name": "Arenukvern",
- "url": "https://github.com/Arenukvern/mcp_flutter"
- },
- "plugins": [
- {
- "name": "flutter-mcp-toolkit",
- "source": "./plugin",
- "description": "Flutter MCP toolkit: inspect and drive debug apps (semantic snapshot, tap, hot-reload) and register custom MCP tools and resources at runtime from your Flutter app or game via mcp_toolkit — closed agent feedback loop.",
- "version": "7.2.1",
- "keywords": [
- "flutter",
- "dart",
- "mcp",
- "mcp-toolkit",
- "vm-service",
- "inspector",
- "live-edit",
- "dynamic-tools",
- "runtime-tools",
- "game-debug"
- ],
- "skills": [
- "./skills"
- ]
- }
- ]
- }
README.md · README · 204 lines · 1 finding marked
- <div align="center">
- <img src="docs/assets/logo.png" alt="flutter-mcp-toolkit logo" width="160" />
- # flutter-mcp-toolkit
- [](https://mcptoplist.com/server/glama%2FArenukvern%2Fmcp_flutter)
- _Inspect and drive a running Flutter app from your AI assistant._
- [](https://skills.sh/arenukvern/mcp_flutter)
- [](https://pub.dev/packages/mcp_toolkit)
- [](https://github.com/Arenukvern/mcp_flutter/actions/workflows/contract_gates.yml)
- [](https://github.com/Arenukvern/mcp_flutter/actions/workflows/intentcall_eval.yml)
- [](https://github.com/Arenukvern/mcp_flutter/actions/workflows/skill_assets_drift.yml)
- [](https://docs.page/arenukvern/mcp_flutter/)
- [](https://deepwiki.com/Arenukvern/mcp_flutter)
- [](https://opensource.org/licenses/MIT)
- [](https://flutter.dev)
- [](https://smithery.ai/server/@Arenukvern/mcp_flutter)
- [](https://registry.modelcontextprotocol.io/v0/servers/io.github.Arenukvern%2Fflutter-mcp-toolkit/versions)
- [](https://github.com/Arenukvern/mcp_flutter#contributors-)
- <a title="Discord" href="https://discord.com/invite/y54DpJwmAn" ><img src="https://img.shields.io/discord/696688204476055592.svg" /></a>
- [](https://github.com/Arenukvern/skill_steward)
- </div>
- Docs: [docs.page/arenukvern/mcp_flutter](https://docs.page/arenukvern/mcp_flutter/) · [llms.txt](./llms.txt) · Contribute: [guide](docs/contributing/guide.mdx)
- **flutter-mcp-toolkit** is a Dart MCP server plus the `mcp_toolkit` Flutter package. An agent can discover your debug app, read semantic UI snapshots, tap and type, hot-reload, and call **custom tools your app registers at runtime** — a closed loop with runtime proof instead of guessing.
- 
- The picture's story: the toolkit gives an AI assistant a shared window and control loop into a running Flutter app, so it can inspect state, act like a user, hot reload, read proof, and use custom tools from your app instead of guessing.
- 
- ## See it in action
- Existing walkthroughs (YouTube):
- - Dynamic tools in Cursor — [short video](https://www.youtube.com/watch?v=Qog3x2VcO98)
- - Grok Build (2026, June) — [video](https://youtu.be/P0ObCyt0k3M)
- - IntentCall / WebMCP projection — [video](https://www.youtube.com/watch?v=mX4xxVeImq0)
- - Cursor MCP setup — [video](https://www.youtube.com/watch?v=pyDHaI81uts)
- Full list and suggested watch order: [Video walkthroughs](docs/concepts/video-walkthroughs.mdx).
- ## Evaluate in 30 seconds
- | Question | Answer |
- | --- | --- |
- | What is it? | MCP server (`flutter-mcp-toolkit-server`) + in-app `mcp_toolkit` bootstrap over the VM service. |
- | What can an agent do? | Inspect UI/errors, drive widgets, reload, screenshots (Flutter render pipeline), dynamic app tools. |
- | When to use this vs [Dart MCP](https://github.com/dart-lang/ai/tree/main/pkgs/dart_mcp_server)? | **Dart MCP:** Dart/Flutter *tooling* (analyzer, tests). **This toolkit:** a *running debug app* (UI + your app-defined tools). |
- | When not to use it? | Release builds, no debug VM, or you only need static analysis — use Dart MCP or CI instead. |
- | Supported install targets | Release binaries: **macOS Apple Silicon** and **Linux x64** ([details](docs/install/platforms.mdx)). Intel macOS is deprecated. |
- | Fastest proof | [Quickstart](docs/quickstart.mdx) → `doctor` → agent calls `fmt_discover_debug_apps` + `fmt_semantic_snapshot`. |
- | Tool list | Generated: [docs/reference/tools.mdx](docs/reference/tools.mdx) (regenerate with `make docs-reference`). |
- ## Five-minute quickstart
- **1. Marketplace (recommended)** — see [client setup](docs/install/clients.mdx):
- ```text
- Claude Code: /plugin marketplace add Arenukvern/mcp_flutter
- /plugin install flutter-mcp-toolkit@flutter-mcp-toolkit
- Cursor: flutter-mcp-toolkit init cursor # needs CLI on PATH — install script first
- Codex: codex plugin marketplace add Arenukvern/mcp_flutter
- ```
- **2. Install script (recommended for server + CLI on PATH)** — curl:
- `curl -fsSL https://raw.githubusercontent.com/Arenukvern/mcp_flutter/main/install.sh | bash`
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 74 on GitHub
- **3. Instrument the app** — `cd my_flutter_app && flutter-mcp-toolkit codegen-init` (paste `main()` snippet before `runApp`).
- **4. Run and verify** — `flutter run --debug` then `flutter-mcp-toolkit doctor`.
- Connect the MCP server in your host (`flutter-mcp-toolkit-server` on stdio). Example for Claude Code:
- ```bash
- claude mcp add flutter-mcp-toolkit -- flutter-mcp-toolkit-server
- ```
- First agent prompt: *“Discover debug Flutter apps, connect, and return a semantic snapshot.”*
- Full steps: [docs/quickstart.mdx](docs/quickstart.mdx).
- ## What do you want to do?
- | Goal | Start here |
- | --- | --- |
- | See what is on screen | [See the UI](docs/use-cases/see-the-ui.mdx) |
- | Tap, type, scroll | [Drive the UI](docs/use-cases/drive-the-ui.mdx) |
- | Debug errors + reload loop | [Debug a running app](docs/use-cases/debug-a-running-app.mdx) |
- | Custom MCP tools in your app | [Custom tools](docs/use-cases/custom-tools.mdx) |
- | Scripts / CI one-shots | [CI and scripts](docs/use-cases/ci-and-scripts.mdx) |
- | Checked-in E2E | [E2E scenarios](docs/use-cases/e2e-scenarios.mdx) |
- | Several apps at once | [Multiple apps](docs/use-cases/multiple-apps.mdx) |
- ## Packages
- | Package | Role |
- | --- | --- |
- | [`mcp_toolkit`](https://pub.dev/packages/mcp_toolkit) | Flutter app bootstrap, VM extensions, dynamic tools |
- | `flutter_mcp_toolkit_core` / `capability_*` | Shared contracts and `fmt_*` server capabilities |
- | `flutter_mcp_harness` | Programmatic automation ([packages/harness](packages/harness/README.md)) |
- Server binary: GitHub Releases (`flutter-mcp-toolkit`, `fmtk`, `flutter-mcp-toolkit-server`) — not on pub.dev. See [mcp_server_dart/README.md](mcp_server_dart/README.md).
- ## News (recent)
- - **2026-11** — Docs-first refresh, generated tool reference, registry publish hardening.
- - **2026-10-02** — 6.0.0 invoke tier / harness composition ([automation chain](docs/concepts/automation-chain.mdx)).
- Older releases: [CHANGELOG.md](CHANGELOG.md).
- ## Security & trust
- Debug-mode only by design. Overview: [how it works](docs/concepts/how-it-works.mdx). Assessed by [MseeP.ai](https://mseep.ai/app/arenukvern-mcp-flutter).
- [](https://mseep.ai/app/arenukvern-mcp-flutter)
- Smithery listing is currently unavailable (404 as of 2026-11); use the [official MCP Registry](https://registry.modelcontextprotocol.io) or marketplace install. Relisting requires owner action on Smithery.
- ## Contributing
- [CONTRIBUTING.md](CONTRIBUTING.md) · [contribution guide](docs/contributing/guide.mdx) · `make check-contracts` before PRs.
- ## ✨ Contributors
- Huge thanks to all contributors for making this project better!
- This roster is maintained with [all-contributors](https://allcontributors.org/).
- To add someone, update [`.all-contributorsrc`](.all-contributorsrc) and
- regenerate the README table, or use the all-contributors bot/CLI from a PR.
- More detail: [docs/contributing/contributors.mdx](docs/contributing/contributors.mdx).
- <!-- https://allcontributors.org/docs/en/bot/usage -->
- <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
- <!-- prettier-ignore-start -->
- <!-- markdownlint-disable -->
- <table>
- <tbody>
- <tr>
- <td align="center" valign="top" width="14.28%"><a href="https://calclavia.com"><img src="https://avatars.githubusercontent.com/u/1828968?v=4&size=100" width="100px" height="100px" alt="Henry Mao"/><br /><sub><b>Henry Mao</b></sub></a><br /><a href="#infra-calclavia" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/marwenbk"><img src="https://avatars.githubusercontent.com/u/18284646?v=4&size=100" width="100px" height="100px" alt="Marwen"/><br /><sub><b>Marwen</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=marwenbk" title="Documentation">📖</a></td>
- <td align="center" valign="top" width="14.28%"><a href="http://eastagile.com"><img src="https://avatars.githubusercontent.com/u/2829939?v=4&size=100" width="100px" height="100px" alt="Lawrence Sinclair"/><br /><sub><b>Lawrence Sinclair</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=lwsinclair" title="Documentation">📖</a> <a href="#security-lwsinclair" title="Security">🛡️</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://glama.ai"><img src="https://avatars.githubusercontent.com/u/108313943?v=4&size=100" width="100px" height="100px" alt="Frank Fiegel"/><br /><sub><b>Frank Fiegel</b></sub></a><br /><a href="#infra-punkpeye" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/Harishwarrior"><img src="https://avatars.githubusercontent.com/u/38380040?v=4&size=100" width="100px" height="100px" alt="Harish Anbalagan"/><br /><sub><b>Harish Anbalagan</b></sub></a><br /><a href="#userTesting-Harishwarrior" title="User Testing">📓</a> <a href="https://github.com/Arenukvern/mcp_flutter/issues?q=author%3AHarishwarrior" title="Bug reports">🐛</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/torbenkeller"><img src="https://avatars.githubusercontent.com/u/33001558?v=4&size=100" width="100px" height="100px" alt="Torben Keller"/><br /><sub><b>Torben Keller</b></sub></a><br /><a href="#userTesting-torbenkeller" title="User Testing">📓</a> <a href="https://github.com/Arenukvern/mcp_flutter/issues?q=author%3Atorbenkeller" title="Bug reports">🐛</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/rednikisfun"><img src="https://avatars.githubusercontent.com/u/53967674?v=4&size=100" width="100px" height="100px" alt="Isfun"/><br /><sub><b>Isfun</b></sub></a><br /><a href="#userTesting-rednikisfun" title="User Testing">📓</a> <a href="https://github.com/Arenukvern/mcp_flutter/issues?q=author%3Arednikisfun" title="Bug reports">🐛</a> <a href="#research-rednikisfun" title="Research">🔬</a> <a href="https://github.com/Arenukvern/mcp_flutter/commits?author=rednikisfun" title="Code">💻</a></td>
- </tr>
- <tr>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/cosystudio"><img src="https://avatars.githubusercontent.com/u/149987661?v=4&size=100" width="100px" height="100px" alt="Cosy Studio"/><br /><sub><b>Cosy Studio</b></sub></a><br /><a href="#userTesting-cosystudio" title="User Testing">📓</a> <a href="https://github.com/Arenukvern/mcp_flutter/issues?q=author%3Acosystudio" title="Bug reports">🐛</a> <a href="#research-cosystudio" title="Research">🔬</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/lukemmtt"><img src="https://avatars.githubusercontent.com/u/1598289?v=4&size=100" width="100px" height="100px" alt="Luke Memet"/><br /><sub><b>Luke Memet</b></sub></a><br /><a href="#userTesting-lukemmtt" title="User Testing">📓</a> <a href="#research-lukemmtt" title="Research">🔬</a> <a href="#maintenance-lukemmtt" title="Maintenance">🚧</a> <a href="#tutorial-lukemmtt" title="Tutorials">✅</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://commentatk-media.com"><img src="https://avatars.githubusercontent.com/u/70331129?v=4&size=100" width="100px" height="100px" alt="Commentatk Media"/><br /><sub><b>Commentatk Media</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=CommentakMedia" title="Code">💻</a> <a href="#maintenance-CommentakMedia" title="Maintenance">🚧</a> <a href="https://github.com/Arenukvern/mcp_flutter/commits?author=CommentakMedia" title="Documentation">📖</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/umitarslan/"><img src="https://avatars.githubusercontent.com/u/4801240?v=4&size=100" width="100px" height="100px" alt="Umit Arslan"/><br /><sub><b>Umit Arslan</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=arslanmit" title="Code">💻</a> <a href="#maintenance-arslanmit" title="Maintenance">🚧</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://joelkitching.com/"><img src="https://avatars.githubusercontent.com/u/514199?v=4&size=100" width="100px" height="100px" alt="Joel Kitching"/><br /><sub><b>Joel Kitching</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=jkitching" title="Code">💻</a> <a href="#maintenance-jkitching" title="Maintenance">🚧</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/jeanlucthumm"><img src="https://avatars.githubusercontent.com/u/4934853?v=4&size=100" width="100px" height="100px" alt="Jean-Luc Thumm"/><br /><sub><b>Jean-Luc Thumm</b></sub></a><br /><a href="#maintenance-jeanlucthumm" title="Maintenance">🚧</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/tekboxs"><img src="https://avatars.githubusercontent.com/u/64443719?v=4&size=100" width="100px" height="100px" alt="Miguel Casagrande"/><br /><sub><b>Miguel Casagrande</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=tekboxs" title="Code">💻</a> <a href="#maintenance-tekboxs" title="Maintenance">🚧</a></td>
- </tr>
- <tr>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/drown0315"><img src="https://avatars.githubusercontent.com/u/108989782?v=4&size=100" width="100px" height="100px" alt="drown0315"/><br /><sub><b>drown0315</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=drown0315" title="Code">💻</a> <a href="#maintenance-drown0315" title="Maintenance">🚧</a> <a href="https://github.com/Arenukvern/mcp_flutter/issues?q=author%3Adrown0315" title="Bug reports">🐛</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/druyang"><img src="https://avatars.githubusercontent.com/u/46964831?v=4&size=100" width="100px" height="100px" alt="druyang"/><br /><sub><b>druyang</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=druyang" title="Code">💻</a> <a href="#maintenance-druyang" title="Maintenance">🚧</a> <a href="https://github.com/Arenukvern/mcp_flutter/issues?q=author%3Adruyang" title="Bug reports">🐛</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/dipsy"><img src="https://avatars.githubusercontent.com/u/1336665?v=4&size=100" width="100px" height="100px" alt="dipsy"/><br /><sub><b>dipsy</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=dipsy" title="Code">💻</a> <a href="#maintenance-dipsy" title="Maintenance">🚧</a> <a href="https://github.com/Arenukvern/mcp_flutter/issues?q=author%3Adipsy" title="Bug reports">🐛</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/wenyue"><img src="https://avatars.githubusercontent.com/u/4454019?v=4&size=100" width="100px" height="100px" alt="wenyue"/><br /><sub><b>wenyue</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=wenyue" title="Code">💻</a> <a href="#maintenance-wenyue" title="Maintenance">🚧</a></td>
- <td align="center" valign="top" width="14.28%"><a href="http://biff.ai"><img src="https://avatars.githubusercontent.com/u/10966918?v=4&size=100" width="100px" height="100px" alt="Christophe"/><br /><sub><b>Christophe</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=chrstphe" title="Documentation">📖</a> <a href="#platform-chrstphe" title="Packaging/porting to new platform">📦</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/PiotrMitkowski"><img src="https://avatars.githubusercontent.com/u/1737922?v=4&size=100" width="100px" height="100px" alt="Piotr Mitkowski"/><br /><sub><b>Piotr Mitkowski</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=PiotrMitkowski" title="Code">💻</a> <a href="#maintenance-PiotrMitkowski" title="Maintenance">🚧</a> <a href="https://github.com/Arenukvern/mcp_flutter/issues?q=author%3APiotrMitkowski" title="Bug reports">🐛</a></td>
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/KuljeetSinghXDA"><img src="https://avatars.githubusercontent.com/u/22261392?v=4&size=100" width="100px" height="100px" alt="Kuljeet Singh"/><br /><sub><b>Kuljeet Singh</b></sub></a><br /><a href="https://github.com/Arenukvern/mcp_flutter/commits?author=KuljeetSinghXDA" title="Code">💻</a> <a href="#maintenance-KuljeetSinghXDA" title="Maintenance">🚧</a> <a href="https://github.com/Arenukvern/mcp_flutter/issues?q=author%3AKuljeetSinghXDA" title="Bug reports">🐛</a></td>
- </tr>
- </tbody>
- </table>
- <!-- markdownlint-restore -->
- <!-- prettier-ignore-end -->
- <!-- ALL-CONTRIBUTORS-LIST:END -->
- ## 📖 Learn More
- - [Flutter DevTools Documentation](https://docs.flutter.dev/development/tools/devtools/overview)
- - [Dart VM Service Protocol](https://github.com/dart-lang/sdk/blob/main/runtime/vm/service/service.md)
- - [Flutter DevTools RPC Constants (I guess and hope they are correct:))](https://github.com/flutter/devtools/tree/87f8016e2610c98c3e2eae8b1c823de068701dfd/packages/devtools_app/lib/src/shared/analytics/constants)
- ## Star History
- <a href="https://star-history.dera.page/#Arenukvern/mcp_flutter&type=date">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=Arenukvern/mcp_flutter&type=date&theme=dark&legend=top-left" />
- <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=Arenukvern/mcp_flutter&type=date&legend=top-left" />
- <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=Arenukvern/mcp_flutter&type=date&legend=top-left" />
- </picture>
- </a>
- ## 📄 License
- [MIT](LICENSE) - Feel free to use in your projects!
- ---
- _Flutter and Dart are trademarks of Google LLC._
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.