# FlutterSDK Dusk

> FlutterSDK Dusk is an open-source MCP server for developer tools. Lets AI agents and developers snapshot and drive a running Flutter app in debug builds. It is available on CLI, API, macOS, Windows, Linux, iOS, Android, Web and vscode.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, macOS, Windows, Linux, iOS, Android, Web, vscode
- **Website:** https://fluttersdk.com/dusk
- **Repository:** https://github.com/fluttersdk/dusk
- **MCP Registry name:** io.github.fluttersdk/dusk
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says Tapir reads the Semantics tree of a live Flutter app and then acts on it through stable element refs, so a human or an agent can tap, type, scroll and screenshot without writing a flutter_test file between steps. It is exposed both as a CLI and as an MCP server whose tools mirror the same commands.

Each gesture passes an actionability check before it fires: the widget must be enabled, on screen, stable across frames and not covered by another widget. When a check fails, the response names the reason so a caller can branch on it. Responses can also report the observed effect of an action, which the README distinguishes from simply having dispatched the event.

It is aimed at Flutter developers who want an agent to verify UI behaviour in a running app, and it also includes frame and widget-build profiling. It is intended for debug and profile builds only, and the README warns against shipping it in release.

## Features

- **Semantics tree snapshots:** Reads the running app's accessibility tree as YAML with stable element refs for each node.
- **Gated UI actions:** Taps, typing, scrolling and other gestures wait for the target to be enabled, visible, stable and hit-testable.
- **CLI and MCP parity:** Every command is also available as an MCP tool, so agents and terminal users share one contract.
- **Screenshots and device emulation:** Captures the viewport or a single widget as JPEG or PNG and offers device presets for emulation.
- **Frame and build profiling:** Brackets an interaction to show which widget types rebuilt and how long frames took.
- **Optional Wind and Magic state:** Can add Wind class-cache counters and Magic state to snapshots when those packages are used.

## Good for

- Letting a coding agent verify a Flutter UI change by tapping through the running app
- Scripting end-to-end checks on a debug build without a flutter_test harness
- Capturing screenshots of specific widgets or device viewports during development
- Diagnosing why a Flutter widget interaction fails by reading the refusal reason
- Profiling which widgets rebuild during a single user interaction

## FAQ

### Does it work in release builds?

No. The README says to install it behind a !kReleaseMode guard, since anyone who can reach the VM Service of a build carrying it could drive the app.

### How is it installed?

With flutter pub add tapir, then dart run tapir tapir:install, which patches lib/main.dart and scaffolds a dowel wrapper.

### What license is it under?

The README and website both state MIT.

### Which AI clients does it connect to?

The README lists setup steps for Claude Code, VS Code, Cursor, Windsurf, Goose, Warp, Claude Desktop and Codex through its dowel MCP server.

### Is FlutterSDK Dusk free?

Yes. FlutterSDK Dusk is open source, so you can use and self-host it for free.

### What are the best alternatives to FlutterSDK Dusk?

The closest alternatives to FlutterSDK Dusk are Tapir, FlutterSDK Telescope, Flutter MCP Toolkit, FlutterSDK Artisan and Crumbs.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.

## Alternatives

- [Tapir](https://ai-powered.com/mcp/tapir): Tapir is an open-source MCP server for developer tools.
- [FlutterSDK Telescope](https://ai-powered.com/mcp/fluttersdk-telescope): FlutterSDK Telescope is an open-source MCP server for developer tools.
- [Flutter MCP Toolkit](https://ai-powered.com/mcp/flutter-mcp-toolkit): Flutter MCP Toolkit is an open-source MCP server for developer tools.
- [FlutterSDK Artisan](https://ai-powered.com/mcp/fluttersdk-artisan): FlutterSDK Artisan is an open-source MCP server for developer tools.
- [Crumbs](https://ai-powered.com/mcp/crumbs): Crumbs is an open-source MCP server for developer tools.
- [looktap](https://ai-powered.com/mcp/looktap): looktap is an open-source MCP server for developer tools.
- [simframe](https://ai-powered.com/mcp/simframe): simframe is an open-source MCP server for developer tools.
- [Tapp](https://ai-powered.com/mcp/tapp): Tapp is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/fluttersdk-dusk
