Not sure if Cursor still requires the experimental flag when setting up the MCP server

[sethladd]

Page URL

https://docs.flutter.dev/ai/mcp-server

Page source

https://github.com/flutter/website/blob/main/src/content/ai/mcp-server.md

Describe the problem

The other tools' MCP configurations look like:

"command": "dart",
      "args": [
        "mcp-server"
      ]

but for Cursor (on this page), we still say:

dart": {
      "command": "dart",
      "args": [
        "mcp-server",
        "--experimental-mcp-server",
        "--force-roots-fallback"
      ]

Not sure if experimental and force-roots-fallback are still required for Cursor?

Expected fix

No response

Additional context

No response

I would like to fix this problem.

• I will try and fix this problem on docs.flutter.dev.

[sethladd]

cc @anderdobo , wdyt?

[sfshaza2]

@johnpryan?

[johnpryan]

I'm unable to use Cursor on my machine, but I don't see why we would recommend the experimental flags for Cursor and not other IDEs. #12634

[DanTup]

Are we sure both of these flags aren't needed for Cursor? (cc @jakemac53)

At https://github.com/dart-lang/ai/blob/main/pkgs/dart_mcp_server/README.md#cursor it specifically mentions --force-roots-fallback is a workaround for a Cursor issue. It seems deliberate that this differs from the standard non-Cursor arguments.

(It also says --experimental-mcp-server is only required for < Dart 3.9.. I don't know if we would want to wait a little before removing it for users that might not have upgraded yet)

[jakemac53]

The --force-roots-fallback may still be needed, but --experimental-mcp-server can likely be dropped. As @DanTup said it depends on your dart version.

[johnpryan]

Thanks for flagging that, Cursor claims that they support roots, but I can't verify if this is still required.

[DanTup]

I'm not sure exactly what the issue was with Cursor (maybe @jakemac53 can confirm), but I'll note that the help text here:

https://github.com/dart-lang/ai/blob/0a85ddf4f75cee6e3abe07cecdffae69bbdbc793/pkgs/dart_mcp_server/lib/src/arg_parser.dart#L40-L43

says:

This can be helpful for clients like Cursor which claim to have roots support but do not actually support it.

So it's not guaranteed that their docs match the behaviour (of course, it's possible that whatever the issue was has been resolved).

[jakemac53]

We should definitely re-validate whether they actually set roots. If they do, we can stop shaming them in the help text LOL