# 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](/mcp/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](https://github.com/Arenukvern/mcp_flutter/issues/68) · 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)
<asynchronous suspension>
#1      RegistryDiscoveryService.registerToolsAndResources (package:flutter_inspector_mcp_server/src/dynamic_registry/registry_discovery_service.dart:167)
<asynchronous suspension>
#2      DynamicRegistryTools._handleListClientToolsAndResources (package:flutter_inspector_mcp_server/src/dynamic_re

[Read the thread](https://github.com/Arenukvern/mcp_flutter/issues/59) · 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:

<img width="531" alt="Image" src="https://github.com/user-attachments/assets/f8697004-f12a-4a04-8b07-6947c2271ce7" />

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

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

[Read the thread](https://github.com/Arenukvern/mcp_flutter/issues/53) · 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](https://github.com/Arenukvern/mcp_flutter/blob/main/QUICK_START.md) 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](https://github.com/Arenukvern/mcp_flutter/issues/51) · 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](https://github.com/Arenukvern/mcp_flutter/issues/135) · 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](https://github.com/Arenukvern/mcp_flutter/issues/116) · 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

1. Run Flutter app in debug mode
```bash
flutter run
```

2. Connect MCP Toolkit to Flutter VM Service

3. R

[Read the thread](https://github.com/Arenukvern/mcp_flutter/issues/94) · 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](https://github.com/IgorGanapolsky/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:

```bash

[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).
