dart_mcp_server

1.2.2

• The dtd tool's listConnectedApps command no longer returns an error when connected to a DTD instance that has no running apps. It now always refreshes the app list from DTD and explains how to find the right app or DTD instance.
• When an app tool is called before connecting to DTD, the error now includes the available DTD instances and the exact connect call to make, and reports the dtdNotConnected failure reason instead of noActiveDebugSession.
• Clarify the dtd tool description and server instructions to make it clear that listDtdUris and connect must be called before other app tools.
• Connecting to a DTD instance that is already connected now succeeds and returns its current apps instead of returning a dtdAlreadyConnected error, and listDtdUris indicates which instances are already connected. This is common when the server is shared across multiple agent sessions.

1.2.1

• When the Flutter SDK cannot be found, the error now says which Dart SDK the server is using and where that path came from (an explicit path such as --dart-sdk, DART_ROOT, DART_SDK, or the running executable), and mentions --flutter-sdk.
• Fix the --enable help text, which incorrectly said that all features are enabled by default. Document how to enable tools that are disabled by default in the README.
• Require package:unified_analytics ^8.1.0.

1.2.0

• Add a listRegisteredServices command to the vm_service tool, which lists the services that VM service clients registered on a running app, with their human readable aliases.
• The vm_service tool's callMethod command now accepts the name a service was registered with, and calls the namespaced method (e.g. s1.myService) for it. If more than one client registered the service, it returns an error listing the method names and aliases to choose from.

1.1.3

• Only include the command argument in the tool name sent to analytics when it is one of the commands the tool supports, and report unsupported commands as noSuchCommand failures.
• Only send the names of this server's own prompts to analytics, and report requests for any other prompt as noSuchPrompt failures.
• Sanitize the client name, client version, and agent plugin before sending them to analytics.

1.1.2

• Let the create tool pass the project root to the underlying CLI, and reject an empty directory.
• Reject a create template carrying whitespace, a non-breaking space included.
• Track AGENT_PLUGIN environment variable in analytics events.
• Add missing license headers.

1.1.1

• Improve server instructions and error messages to encourage agents to proactively connect to running applications and hot reload after changes.

1.1.0

• Build against the published dart_mcp package instead of a local path override.
• Create vm_service meta tool, which allows direct connections to apps via vm service URIs, and also handles the direct vm service method calls.
• Add additional failure reasons to tool call analytics.
• Move SdkSupport to implements instead of on in DartToolingDaemonSupport.
• Harden various tools against compromised agents.
• Use new analysis request that blocks until analysis is complete, instead of waiting for notifications, which may never come.
• Use shared logic from unified_analytics to parse the Dart version.
• Log error types for uncaught errors.

1.0.2

• Send a SIGKILL to the analysis server if it doesn't respond to a SIGTERM in time.

1.0.1

• Minor changes to improve pub score.

1.0.0

• Package is now shipped on pub instead of through the SDK. The dart mcp-server command will continue to work as an alias for dart run dart_mcp_server@.
• Support reading DART_ROOT environment variable to set the Dart SDK root.
• Always enable roots fallback, and merge them with client roots that are set (if any).
• Add a tool for making arbitrary vm service method calls to connected apps.
• Move binary to bin/dart_mcp_server.dart to be compatible with dart run.
• Add support for enabling analytics when running as a package based on the DASH__TOOL environment variable. Analytics will not be tracked if this is not set.

0.1.3 (Dart SDK 3.12.0)

• Add additional analytics for initialization events, and various list* method calls. This will help understand how the server is being used by different clients, and what features clients support.
• Add a tool for running ripgrep on package dependencies.
• Add categories for MCP features, allowing enabling/disabling tools by category or name.
  • This replaces the now deprecated --tools and --exclude-tool flags, but both are still supported for backward compatibility. --tools=dart now becomes --disable=flutter and --exclude-tool is just an alias for --disable.
• Add timeout option to launch_app.
• Add args parameter to launch_app to support passing additional flags to flutter run (e.g. --flavor, --dart-define, --dart-define-from-file). Managed flags (--print-dtd, --machine, --device-id, --target, -d, -t) are blocked and must be passed via their dedicated parameters instead.
• The read_package_uris tool now supports resolving the package-root: scheme to read package structure beyond the lib/ directory.
• The read_package_uris tool now returns flattened text and image Content payloads when traversing directories and symlinks rather than ResourceLinks or embedded resources. This has better support across all clients.
• Expose set_frame_sync command in the flutter_driver tool, allowing agents to disable frame synchronization for apps with continuous animations (Rive, Lottie, etc.) that cause tap/waitFor to time out (issue #391).
• Fix nested finder JSON serialization for Ancestor/Descendant finders in the flutter_driver tool (issue #345).
• Fix analyze_files returning false "No errors" when paths parameter is specified.
• Merge get_selected_widget, get_widget_tree, set_widget_selection_mode into widget_inspector tool.
• Merge hover, signatureHelp, resolveWorkspaceSymbol into lsp tool.
• Disable all tools that can easily be done on the CLI by default, as well as get_active_location. These can be re-enabled by passing --enable cli or --enable <tool-name>.
• Add support for auto-fixing diagnostics returned by analyze_files.
• Updated server instructions to encourage listing resources, using the tools to read and grep package contents, and to explain package-root: URIs.
• Disable by default the launch_app, and associated tools (list_running_apps, get_app_logs, list_devices, stop_app). These can be re-enabled by passing --enable flutter_app_lifecycle (to enable all of them) or --enable <tool-name> (to enable specific ones). Agents tend to do better just using the CLI to manage the app lifecycle, and it is more flexible.
• Fixed the web_server device for launch_app to return just the URI that should be opened in a browser, we do not get a DTD or Vm Service URI until the app is actually connected, which was causing timeouts.
• Compact the output of the analyze_files tool to reduce token usage.
• Start analysis server instances lazily, and time them out after 10 minutes of inactivity.
• Enable set_semantics command for flutter_driver.
• Add listDtdUris subcommand for the dtd tool.

0.1.2 (Dart SDK 3.11.0)

• Add --tools=dart|all argument to allow enabling only vanilla Dart tools for non-flutter projects.
• Include the device name and target platform in the list_devices tool.
• Fix analyze tool handling of invalid roots.
• Fix erroneous SDK version error messages when connecting to a VM Service instead of DTD URI.
• Add a tool for reading package: URIs. Results are returned as embedded resources or resource links (when reading a directory).
• Add additionalProperties: false to most schemas so they provide better errors when invoked with incorrect arguments.
• Add DartMcpServer.samplingRequest service extension method to send a sampling request over DTD.
• Fix the timeout parameter for the flutter_driver tool to be a String, matching the underlying expected type (issue #330).

0.1.1 (Dart SDK 3.10.0)

• Change tools that accept multiple roots to not return immediately on the first failure.
• Add failure reason field to analytics events so we can know why tool calls are failing.
• Add a flutter_driver command for executing flutter driver commands on a device.
• Allow for multiple package arguments to pub add and pub remove.
• Require dart_mcp version 0.3.1.
• Add support for the flutter_driver screenshot command.
• Change the widget tree to the full version instead of the summary. The summary tends to hide nested text widgets which makes it difficult to find widgets based on their text values.
• Add an --exclude-tool command line flag to exclude tools by name.
• Add the abillity to limit the output of analyze_files to a set of paths.
• Stop reporting non-zero exit codes from command line tools as tool errors.
• Add descriptions for pub tools, add support for pub deps and pub outdated.
• Fix a bug in hot_reload (#290).
• Add the list_devices, launch_app, get_app_logs, and list_running_apps tools for running Flutter apps.
• Add the hot_restart tool for restarting running Flutter apps.
• Add extra log output to failed launches, and allow AI to specify the maxLines of log output.
• Convert launch_app to use --machine output to capture the DTD URI.
• Remove a reference to "screenshot" for a generic error that occurs for more than just screenshots.
• Mark the "root" parameter for create_project required.

0.1.0 (Dart SDK 3.9.0)

• Add documentation/homepage/repository links to pub results.
• Handle relative paths under roots without trailing slashes.
• Fix executable paths for dart/flutter on windows.
• Pass the provided root instead of the resolved root for project type detection.
• Be more flexible about roots by comparing canonicalized paths.
• Create the working dir if it doesn't exist.
• Add the --platform and --empty arguments to the flutter create tool.
• Invoke dart/flutter in a more robust way.
• Remove qualifiedNames from the pub dev api search.
• Flutter/Dart create tool.
• Limit the tokens returned by the runtime errors tool/resource.
• Add RootsFallbackSupport mixin.
• Fix error handling around stream listeners.
• Add a 'pub-dev-search' mcp tool.
• Drop pubspec-parse, use yaml instead.
• Handle failing to listen to vm service streams during startup.
• Add tool for enabling/disabling the widget selector.
• Add a tool to get the active cursor location.
• Add hover tool support.
• Add a test command and project detection.
• Add signature_help tool.
• Add runtime errors resource and tool to clear errors.
• Require roots for all CLI tools.
• Require roots to be set for analyzer tools.
• Add debug logs for when DTD sees Editor.getDebugSessions get registered.
• Add tool annotations to tools.
• Implement a tool to resolve workspace symbols based on a query.
• Add a dart pub tool.
• Update analyze tool to use LSP, simplify tool.
• Add tool for getting the selected widget.
• Handle missing roots capability better.
• Add get_widget_tree tool.
• Add a tool for getting runtime errors.
• Add Dart CLI tool support.
• Add a hot reload tool.
• Add basic analysis support.
• Add the beginnings of a Dart tooling MCP server.
• Instruct clients to prefer MCP tools over running tools in the shell.
• Reduce output size of run_tests tool to save on input tokens.
• Add --log-file argument to log all protocol traffic to a file.
• Improve error text for failed DTD connections as well as the tool description.
• Add support for injecting an Analytics instance to track usage.
• Listen to the new DTD ConnectedApp service instead of the Editor.DebugSessions service, when available.
• Screenshot tool disabled until https://github.com/flutter/flutter/issues/170357 is resolved.
• Add arg_parser.dart public library with minimal deps to be used by the dart tool.