Flutter Inspector MCP Server
Inspect and debug-toggle a running Flutter app in debug mode by proxying Flutter extension RPCs and VM service methods over the Dart VM service (default port 8181).
Discover/connect: list listening Flutter/Dart ports, fetch VM info, supported protocols, and all available extension RPCs (per isolate, optional raw response).
Dump diagnostics trees: render tree, layer tree, semantics tree (traversal and inverse hit-test order), and focus tree.
Inspect widgets: take screenshots, get root/summary/detail subtrees, children summaries and details, parent chains, layout explorer nodes, selected widget info, widget-to-source-location map, and check widget-tree readiness.
Manage inspector state: select widgets by ID, show widget details (group name, subtree depth), track rebuilds and repaints, toggle structured errors, manage/dispose groups and object IDs, and set/add/remove/get pub root directories.
Adjust layout live: set flex fit, flex factor, or combined flex properties on flex children.
Toggle debug rendering flags: debug banner, paint baselines, repaint rainbow, oversized-image inversion, and disable clip / opacity / physical-shape layers.
Tune app environment: override platform and brightness, set animation time dilation, evict cached assets, profile platform channels, and check first-frame sent/rasterized events.
Profile I/O and performance: socket profiling, HTTP timeline logging, open files and file-by-id, HTTP profile request details, Dart/Flutter version, and render-object paint/layout profiling.
Stream events: subscribe to VM streams (Debug, Isolate, VM, GC, Timeline, Logging, Service, HeapSnapshot).
Note: the schema only exposes inspection and debug-flag control — tap/type input, hot reload, semantic snapshots, and app-defined custom tools described in the README are not present here, and
debug_disable_physical_shape_layers/debug_disable_opacity_layersare each listed twice.
Interfaces with Dart VM Service Protocol to access Flutter/Dart process information, retrieve version details, and monitor various event streams for debugging Flutter applications.
Connects to a Flutter app's debug mode to extract data about widget trees, render trees, layer trees, and semantics, enabling AI tools to provide context-aware assistance for Flutter app development.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Flutter Inspector MCP Server check for layout issues in my current screen"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
flutter-mcp-toolkit
Inspect and drive a running Flutter app from your AI assistant.
Docs: docs.page/arenukvern/mcp_flutter · llms.txt · Contribute: guide
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.
Evaluate in 30 seconds
Question | Answer |
What is it? | MCP server ( |
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? | 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). Intel macOS is deprecated. |
Fastest proof | Quickstart → |
Tool list | Generated: docs/reference/tools.mdx (regenerate with |
Related MCP server: flutter-dev-mcp
Five-minute quickstart
1. Marketplace (recommended) — see client setup:
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_flutter2. 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-serverFirst agent prompt: “Discover debug Flutter apps, connect, and return a semantic snapshot.”
Full steps: docs/quickstart.mdx.
What do you want to do?
Goal | Start here |
See what is on screen | |
Tap, type, scroll | |
Debug errors + reload loop | |
Custom MCP tools in your app | |
Scripts / CI one-shots | |
Checked-in E2E | |
Several apps at once |
Packages
Package | Role |
Flutter app bootstrap, VM extensions, dynamic tools | |
| Shared contracts and |
| Programmatic automation (packages/harness) |
Server binary: GitHub Releases (flutter-mcp-toolkit, fmtk, flutter-mcp-toolkit-server) — not on pub.dev. See 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).
Older releases: CHANGELOG.md.
Security & trust
Debug-mode only by design. Overview: how it works. Assessed by MseeP.ai.
Smithery listing is currently unavailable (404 as of 2026-11); use the official MCP Registry or marketplace install. Relisting requires owner action on Smithery.
Contributing
CONTRIBUTING.md · contribution guide · make check-contracts before PRs.
✨ Contributors
Huge thanks to all contributors for making this project better!
This roster is maintained with all-contributors.
To add someone, update .all-contributorsrc and
regenerate the README table, or use the all-contributors bot/CLI from a PR.
More detail: docs/contributing/contributors.mdx.
📖 Learn More
Star History
📄 License
MIT - Feel free to use in your projects!
Flutter and Dart are trademarks of Google LLC.
Available Tools
60 toolsdart_io_get_http_profile_requestC
RPC: Get details of a specific HTTP request from the profile
Inputs: requestId (required), port.
dart_io_get_open_file_by_idC
RPC: Get details of a specific open file by its ID
Inputs: fileId (required), port.
dart_io_get_open_filesC
RPC: Get list of currently open files in the Flutter app
Inputs: port.
dart_io_get_versionC
RPC: Get Flutter version information (ext.dart.io.getVersion)
Inputs: port.
dart_io_http_enable_timeline_loggingB
RPC: Enable or disable HTTP timeline logging. Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: enabled (required), port.
dart_io_socket_profiling_enabledB
RPC: Enable or disable socket profiling. Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: enabled (required), port.
debug_allow_bannerC
RPC: Toggle the debug banner in the Flutter app
Inputs: enabled (required), port.
debug_disable_clip_layersC
RPC: Toggle disabling of clip layers in the Flutter app
Inputs: enabled (required), port.
debug_disable_opacity_layersB
RPC: Toggle opacity layers debugging (ext.flutter.debugDisableOpacityLayers). Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: enabled (required), port.
debug_disable_physical_shape_layersC
RPC: Toggle physical shape layers debugging (ext.flutter.debugDisablePhysicalShapeLayers)
Inputs: enabled (required), port.
debug_dump_focus_treeB
RPC: Dump the focus tree (ext.flutter.debugDumpFocusTree)
Inputs: port.
debug_dump_layer_treeB
RPC: Dump the layer tree (ext.flutter.debugDumpLayerTree). Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: port.
debug_dump_render_treeB
RPC: Dump the render tree (ext.flutter.debugDumpRenderTree). Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: port.
debug_dump_semantics_treeA
RPC: Dump the semantics tree (ext.flutter.debugDumpSemanticsTreeInTraversalOrder). Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: port.
debug_dump_semantics_tree_inverseC
RPC: Dump the semantics tree in inverse hit test order (ext.flutter.debugDumpSemanticsTreeInInverseHitTestOrder)
Inputs: port.
debug_paint_baselines_enabledB
RPC: Toggle baseline paint debugging (ext.flutter.debugPaintBaselinesEnabled). Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: enabled (required), port.
flutter_core_brightness_overrideC
RPC: Override the brightness for the Flutter app
Inputs: brightness (required), port.
flutter_core_did_send_first_frame_eventC
RPC: Check if the first frame event has been sent
Inputs: port.
flutter_core_did_send_first_frame_rasterized_eventC
RPC: Check if the first frame has been rasterized
Inputs: port.
flutter_core_evictC
RPC: Evict an asset from the Flutter app's cache
Inputs: asset (required), port.
flutter_core_invert_oversized_imagesB
RPC: Toggle inverting of oversized images for debugging
Inputs: enabled (required), port.
flutter_core_platform_overrideC
RPC: Override the platform for the Flutter app
Inputs: platform (required), port.
flutter_core_profile_platform_channelsB
RPC: Enable or disable profiling of platform channels
Inputs: enabled (required), port.
flutter_core_time_dilationB
RPC: Set the time dilation factor for animations in the Flutter app
Inputs: dilation (required), port.
get_active_portsA
Utility: Get list of ports where Flutter/Dart processes are listening. This is a local utility, not a Flutter RPC method.
Inputs: no named parameters.
get_extension_rpcsB
Utility: List all available extension RPCs in the Flutter app. This is a helper tool for discovering available methods.
Inputs: isRawResponse, isolateId, port.
get_supported_protocolsB
Utility: Get supported protocols from a Flutter app. This is a VM service method, not a Flutter RPC. Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: port.
get_vm_infoB
Utility: Get VM information from a Flutter app. This is a VM service method, not a Flutter RPC. Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: port.
inspector_add_pub_root_directoriesC
RPC: Add additional root directories for pub packages (ext.flutter.inspector.addPubRootDirectories)
Inputs: directories (required), port.
inspector_dispose_all_groupsA
RPC: Dispose all inspector groups to free up memory (ext.flutter.inspector.disposeAllGroups)
Inputs: port.
inspector_dispose_groupB
RPC: Dispose a specific inspector group to free up memory (ext.flutter.inspector.disposeGroup)
Inputs: groupId (required), port.
inspector_dispose_idB
RPC: Dispose a specific widget ID to free up memory (ext.flutter.inspector.disposeId)
Inputs: id (required), port.
inspector_get_children_details_subtreeC
RPC: Get the children details subtree for a widget (ext.flutter.inspector.getChildrenDetailsSubtree)
Inputs: objectId (required), port.
inspector_get_children_summary_treeB
RPC: Get the children summary tree for a widget (ext.flutter.inspector.getChildrenSummaryTree). Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: objectId (required), port.
inspector_get_details_subtreeB
RPC: Get the details subtree for a widget. This provides detailed information about the widget and its descendants. Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: objectId (required), port.
inspector_get_layout_explorer_nodeB
RPC: Get layout explorer information for a widget (ext.flutter.inspector.getLayoutExplorerNode). Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: objectId (required), port.
inspector_get_parent_chainB
RPC: Get the parent chain for a widget (ext.flutter.inspector.getParentChain). Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: objectId (required), port.
inspector_get_pub_root_directoriesB
RPC: Get the list of root directories for pub packages (ext.flutter.inspector.getPubRootDirectories)
Inputs: port.
inspector_get_root_widget_summary_treeC
RPC: Get the root widget summary tree (ext.flutter.inspector.getRootWidgetSummaryTree)
Inputs: port.
inspector_get_root_widget_summary_tree_with_previewsC
RPC: Get the root widget summary tree with previews from the Flutter app. This provides a hierarchical view of the widget tree with preview information.
Inputs: port.
inspector_get_selected_summary_widgetB
RPC: Get summary information about the currently selected widget in the Flutter app. Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: port.
inspector_get_selected_widgetB
RPC: Get information about the currently selected widget in the Flutter app. Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: port.
inspector_is_widget_creation_trackedB
RPC: Check if widget creation tracking is enabled in the Flutter app.
Inputs: port.
inspector_is_widget_tree_readyA
RPC: Check if the widget tree is ready for inspection (ext.flutter.inspector.isWidgetTreeReady)
Inputs: port.
inspector_remove_pub_root_directoriesB
RPC: Remove root directories from pub packages (ext.flutter.inspector.removePubRootDirectories)
Inputs: directories (required), port.
inspector_screenshotA
RPC: Take a screenshot of the Flutter app (ext.flutter.inspector.screenshot). Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: port.
inspector_set_pub_root_directoriesC
RPC: Set the root directories for pub packages (ext.flutter.inspector.setPubRootDirectories)
Inputs: directories (required), port.
inspector_set_selection_by_idC
RPC: Set the selected widget by ID (ext.flutter.inspector.setSelectionById). Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: selectionId (required), port.
inspector_showC
RPC: Show specific widget details in the Flutter app inspector.
Inputs: options (required), port.
inspector_structured_errorsB
RPC: Enable or disable structured error reporting in the Flutter app.
Inputs: enabled (required), port.
inspector_track_rebuild_dirty_widgetsB
RPC: Track widget rebuilds to identify performance issues (ext.flutter.inspector.trackRebuildDirtyWidgets). Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: enabled (required), port.
inspector_track_repaint_widgetsB
RPC: Track widget repaints to identify rendering performance issues (ext.flutter.inspector.trackRepaintWidgets)
Inputs: enabled (required), port.
inspector_widget_location_id_mapB
RPC: Get a mapping of widget IDs to their source code locations (ext.flutter.inspector.widgetLocationIdMap)
Inputs: port.
layout_set_flex_factorC
RPC: Set the flex factor of a flex child widget (ext.flutter.inspector.setFlexFactor)
Inputs: factor (required), objectId (required), port.
layout_set_flex_fitB
RPC: Set the flex fit property of a flex child widget (ext.flutter.inspector.setFlexFit)
Inputs: fit (required), objectId (required), port.
layout_set_flex_propertiesC
RPC: Set multiple flex properties of a flex child widget (ext.flutter.inspector.setFlexProperties)
Inputs: objectId (required), properties (required), port.
performance_profile_render_object_layoutsC
RPC: Enable or disable profiling of render object layout operations (ext.flutter.profileRenderObjectLayouts)
Inputs: enabled (required), port.
performance_profile_render_object_paintsA
RPC: Enable or disable profiling of render object paint operations (ext.flutter.profileRenderObjectPaints)
Inputs: enabled (required), port.
repaint_rainbowC
RPC: Toggle repaint rainbow debugging (ext.flutter.repaintRainbow)
Inputs: enabled (required), port.
stream_listenA
RPC: Subscribe to a Flutter event stream. This is a VM service method for event monitoring. Connects to the default Flutter debug port (8181) unless specified otherwise.
Inputs: streamId (required), port.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 60 tools
Many tools are distinct, but there are confusingly similar pairs such as inspector_get_root_widget_summary_tree versus inspector_get_root_widget_summary_tree_with_previews, and multiple near-identical dump/toggle variants. With 60 tools, users need deep domain knowledge to pick the right one.
Naming mostly follows snake_case with clear prefixes (debug_, inspector_, dart_io_, flutter_core_). Minor inconsistencies exist (e.g., flutter_core_invert_oversized_images vs debug_paint_baselines_enabled), but overall patterns are recognizable.
60 tools is far beyond a coherent toolkit size for an inspector surface. Many are fine-grained toggles and getters that could be consolidated, making the set unwieldy.
Covers the major Flutter inspector workflows: tree dumps, selection, layout info, debug toggles, pub roots, and HTTP profiling. Some areas like hot reload/restart or broader VM service operations are absent, but within the inspector scope it is fairly complete.
Maintenance
Related MCP Connectors
MCP server to assist with JxBrowser development.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
MCP server for AI dialogue using various LLM models via AceDataCloud
Related MCP Servers
- AlicenseCqualityDmaintenanceA distributable Model Context Protocol (MCP) server that exposes Dart SDK commands for AI-powered development. This server bridges the gap between AI coding assistants and Dart/Flutter development workflows by implementing the Model Context Protocol (MCP).106MIT
- AlicenseAqualityDmaintenanceAn MCP server that wraps Flutter CLI tools into structured, agent-friendly tools for AI coding agents, with features like two-phase test results, output capping, and managed app lifecycle.1516 npm4MIT
- AlicenseBqualityDmaintenanceAn MCP server that lets AI agents see, tap, type, scroll, and assert inside live Flutter apps — no pre-written tests required.28MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for FlutterFlow that uses a command-palette model to manage projects, inspect UI, and apply safe edits via transactional ChangeSets.10MIT