Reported issues for Flutter MCP Toolkit

Pod holds 14 of 14 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to Flutter MCP Toolkit.

Most discussed

“--host-vmservice-port=8181“ does not work on web platforms

The --host-vmservice-port argument does not work on web platforms, and the VM service port is still assigned randomly. `(base) PS E:\CodeBuddy\MCP_server\mcp_flutter\flutter_test_app> flutter run -d chrome --host-vmservice-port=8181 --enable-vm-service --disable-service-auth-codes --web-port=3000 Flutter assets will be downloaded from https://storage.flutter-io.cn. Make sure you trust this source! Launching lib\main.dart on Chrome in debug mode... Waiting for connection from debug service on Chr

Read the thread · 2025-09-23 · open · external user · 2 comments

Unable to fetch listClientToolsAndResources. (Find Available Dynamic Tools)

I'm getting this error.

Bad state: No isolate found #0 VMServiceSupport.callFlutterExtension (package:flutter_inspector_mcp_server/src/mixins/vm_service_support.dart:141) #1 RegistryDiscoveryService.registerToolsAndResources (package:flutter_inspector_mcp_server/src/dynamic_registry/registry_discovery_service.dart:167) #2 DynamicRegistryTools._handleListClientToolsAndResources (package:flutter_inspector_mcp_server/src/dynamic_re

Read the thread · 2025-07-03 · open · external user · 1 comment

TypeError: Cannot read properties of undefined (reading 'split'))

Hi,

Thanks for the great tool. We have successfully setup and have basic MCP usage such as being able to perform hot reload via the mcp:

In the debug mode, we observed that hot reload is working properly as well.

Performing hot reload...                                                
Reloaded 0 libraries in 203ms (compile: 20 ms, reload: 0 ms, reassemble: 49 ms).

Read the thread · 2025-06-16 · closed · external user · 5 comments

The `make install` command is not working in the version 2.2.0

I am trying to setup the latest flutter mcp, and based on the Quick Start Guide I am running make install in mcp_flutter directory, but as I can see in the makefile, it's trying to call make build inside mcp_toolkit. However, I can clearly see in the makefile of mcp_toolkit that there is no build command, which is clearly stated in the output:

`d /Users/isfun/Dev/Flutter/mcp_flutter/mcp_server_dart && dart pub get

Read the thread · 2025-06-11 · closed · external user · 11 comments

Claude Code not using Tools / hot_reload doesn’t work

I want to use Claude Code with this MCP, but it can not use the tools as expected. When I promt to use a tool, it tries, but then it fails:

⏺ flutterInspector:hot_reload_flutter (MCP)
  ⎿  Error: MCP error -32603: Error calling ext.mcpdevtools.hotReload: Unknown method "ext.mcpdevtools.hotReload".

These are the rpcs it gets:

⏺ flutterInspector:get_extension_rpcs (MCP)(port: 8181)
  ⎿  [
       "ext.ui.window.scheduleFrame",
       "ext.ui.window.reinitializeShader",
       "ext.u

[Read the thread](https://github.com/Arenukvern/mcp_flutter/issues/41) · 2025-05-27 · closed · external user · 3 comments

### Can not start mcp server

I switched to the new setup by removing the repository from my disk and cloning it again. Then I ran `make install` and configured the mcp server as in the documentation. Unfortunately my Claude Code can not use the mcp server and I get the following error when starting it:

MCP server "flutter-inspector" Failed to fetch commands: MCP error -32601: Method not found


Steps I already checked:
- verified the configured path. It is correct
- looked into the `index.js`. It is there and contai

[Read the thread](https://github.com/Arenukvern/mcp_flutter/issues/33) · 2025-05-26 · closed · external user · 3 comments

### shutdown does not work

When using `⌃C` to terminate the server, it prints "Shutting down", but it does not complete it and stays forever in that state

[Read the thread](https://github.com/Arenukvern/mcp_flutter/issues/29) · 2025-05-20 · open · external user · 4 comments

### make install fails

When running `make install` there are problems in `mcp_server/src/resources/resource_handlers.ts`

[Read the thread](https://github.com/Arenukvern/mcp_flutter/issues/21) · 2025-04-16 · closed · external user · 3 comments

## Most recent

### Port scan misses Flutter desktop apps: lsof filter matches process name 'dart'/'flutter', so native-process VM services (and all --no-dds instances) are invisible to discovery

## Symptom

Three Flutter desktop instances of the same app run on macOS (`flutter run -d macos`, VM service pinned with `--device-vmservice-port`):

| VM port | DDS | Discovered? |
|---|---|---|
| 8765 | yes | not as 8765 — only the DDS proxy on a random port (`:56709`) |
| 8766 | `--no-dds` | invisible |
| 8767 | `--no-dds` | invisible |

`discover_debug_apps` reports:

```json
{"strategyUsed":"port_scan_flutter_filtered","portRawCount":5,"portCandidateCount":5,"portFlutterCount":1}

Conne

Read the thread · 2026-08-24 · closed · outside contributor · 0 comments

drag rarely wins the gesture arena on desktop: touch-kind synthesis loses to scrollables

Symptom

On desktop targets, drag / fmt_drag over anything scrollable (kanban boards, reorderable lists) usually scrolls the surrounding scrollable instead of dragging the target widget. Success is timing-dependent — the same ref-to-ref drag occasionally lands, mostly doesn't. Reproduced on macOS against a kanban card wrapped in a GestureDetector(onPanStart: ...) inside a vertical ListView inside a horizontal scroll view: out of ~6 synthetic drags, the drop handler fired once; the res

Read the thread · 2026-08-02 · closed · outside contributor · 0 comments

VM isolateId metadata breaks mcp_toolkit service extension validation

MCP Toolkit tool fails in Flutter debug mode

Problem

When running MCP Toolkit tools in Flutter debug mode, some tools fail with validation error.

Error

AgentValidationException: Unknown property "isolateId"

Impact

get_view_details fails
semantic_snapshot fails
get_app_errors fails
Flutter debug inspection features stop working

Steps to reproduce

Run Flutter app in debug mode

flutter run

Connect MCP Toolkit to Flutter VM Service
R

Read the thread · 2026-06-13 · closed · outside contributor · 0 comments

Integration: Add agent memory to Flutter MCP agents

Flutter development agents could benefit from remembering past build failures, widget issues, and platform-specific gotchas across sessions.

MCP Memory Gateway adds:

recall — check what failed on similar tasks before starting
capture_feedback — record build successes/failures with context
prevention_rules — auto-generated rules from repeated mistakes

Works alongside mcp_flutter tools via standard MCP stdio transport:


[Read the thread](https://github.com/Arenukvern/mcp_flutter/issues/78) · 2026-03-12 · open · external user · 1 comment

### [Windows] Bridge package not appearing & VM server connection issue when accessing inspector

Thank you brother, I am using Windows and I have applied all the steps as described.
However, when I go to the site:

http://127.0.0.1:9101?uri=http://127.0.0.1:62155/3mN5Jx7-k5s=

The bridge package does not appear.

The connection to the VM server is not possible.

When I tried the prompt to collect all errors, it was executed successfully, but I received a message saying:

The VM server is not connected

Then I executed another prompt, and this message appeared:

It looks like the Flutter a

[Read the thread](https://github.com/Arenukvern/mcp_flutter/issues/66) · 2025-08-27 · open · external user · 1 comment

### Feat: State Management

Is it possible to expose the state ( Bloc, Provider etc ) to the agent ?

[Read the thread](https://github.com/Arenukvern/mcp_flutter/issues/56) · 2025-06-25 · closed · outside contributor · 1 comment

The remaining reports are on [the project's issue tracker](https://github.com/Arenukvern/mcp_flutter/issues).