• 📖 Docs: docs.page/arenukvern/mcp_flutter
• 🤝 Contribute: guide · contributors · code of conduct · security

flutter-mcp-toolkit is a Dart MCP server + Flutter package for AI agents (Codex, Zed, Cursor, Intent, Claude Code, Cline, and more). Agents can inspect a running Flutter app, take semantic snapshots, tap widgets, type into forms, hot-reload, and read logs. Apps can also register their own MCP tools and resources at runtime via MCP Toolkit — all without leaving the conversation. The result is a closed feedback loop between agent and app; see OpenAI Agentic Harness for an example of this pattern.

The picture's story: the toolkit gives an AI assistant a shared window and control loop into a running Flutter app, so it can inspect state, act like a user, hot reload, read proof, and use custom tools from your app instead of guessing.

![NOTICE]: Version 4 is now stable. Earlier 4.0.0-dev.* builds were prerelease testing builds of the new architecture.

Get started in 4 steps

# 1. Install the binary
curl -fsSL https://raw.githubusercontent.com/Arenukvern/mcp_flutter/main/install.sh | bash
# Installs flutter-mcp-toolkit plus the short fmtk alias for repeated CLI loops.

# 2. Add the toolkit to your Flutter app
cd my-flutter-app
flutter-mcp-toolkit codegen-init   # adds mcp_toolkit + emits main.dart snippet

# 3. Install skills for your AI agent
flutter-mcp-toolkit init claude-code   # or: cursor | codex | cline | agents-skills | all
# Alternative (skills only): npx skills add Arenukvern/mcp_flutter -a cursor -y

# 4. Run
flutter run --debug

That's it. Your AI agent can now inspect and drive the running app — and your app can expose custom MCP tools at runtime (see Dynamic Tools Registration below).

📰 News

• 2026-07-11 - v4 new Live Demos records: v4 semantic snapshot etc.. with Grok Build CLI, v4 with IntentCall power - WebMCP projection

• 2026-05-26 — v3.1.0: Platform-view capture routing, macOS/iOS Simulator host screenshots, web CDP tab capture (SCK → CDP → flutter_layer), and cross-platform showcase platform views.

Install from marketplaces

Docker / MCP Registry install

The official registry serves an OCI image from GHCR. Point any MCP client at it:

{
  "mcpServers": {
    "flutter-mcp-toolkit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network=host",
        "ghcr.io/arenukvern/flutter-mcp-toolkit:4.0.0"
      ]
    }
  }
}

See Docker guide for flags, version pinning, and networking notes.

Maintainers submitting to official stores: marketplace submission runbook. Full matrix: marketplace distribution.

Documentation

• Docs for AI Agent and Human - wiki + llms.txt
• Migrating v2 → v3 — fmt_* MCP tools, binaries, client config keys, validate-runtime.
• MCPCallEntry to AgentCallEntry migration — MCPCallEntry removal, AgentCallEntry, platform codegen sync, fmt_migrate_agent_entries.
• IntentCall consumer guide — hosted intentcall_* dependency policy, consumer proof gates, and the boundary between mcp_flutter and upstream IntentCall architecture.
• Why this repo matters — what it is, why it exists.
• CLI vs MCP — pick the right mode.
• Feature map — the 30 tools.
• AI agent setup - for AI Agents.
• Marketplace distribution — Claude, Cursor, Codex, skills.sh.
• Architecture — for contributors.
• Quick Start, Configuration, MCP RPC description

Published packages

Read the full README on GitHub →