Skip to main content
Glama
Flutter Inspector MCP Server

Flutter Inspector MCP Server

flutter-mcp-toolkit

MCP Toplist

Inspect and drive a running Flutter app from your AI assistant.

skills.sh pub: mcp_toolkit Contract Gates intentcall eval gates skill-assets-drift Docs Ask DeepWiki License: MIT Flutter Official MCP Registry All Contributors maintained with Skill Steward

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 (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?

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 → doctor → agent calls fmt_discover_debug_apps + fmt_semantic_snapshot.

Tool list

Generated: docs/reference/tools.mdx (regenerate with make docs-reference).

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_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.

What do you want to do?

Goal

Start here

See what is on screen

See the UI

Tap, type, scroll

Drive the UI

Debug errors + reload loop

Debug a running app

Custom MCP tools in your app

Custom tools

Scripts / CI one-shots

CI and scripts

Checked-in E2E

E2E scenarios

Several apps at once

Multiple apps

Packages

Package

Role

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)

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 tools
dart_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

    C2.8/5.0

    Scored across 60 tools

    Disambiguation2/5

    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 Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      A 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).
      10
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      15
      16 npm
      4
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that lets AI agents see, tap, type, scroll, and assert inside live Flutter apps — no pre-written tests required.
      28
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for FlutterFlow that uses a command-palette model to manage projects, inspect UI, and apply safe edits via transactional ChangeSets.
      10
      MIT