Agent skill

Flutter MCP Toolkit Guide

by Arenukvern in Arenukvern/mcp_flutter

Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to the right task skill (inspect / control / debug / custom app surfaces) and runs preflight.

MITAuto-check passedMobile

Install Flutter MCP Toolkit Guide

skills CLI
$ npx skills add Arenukvern/mcp_flutter --skill flutter-mcp-toolkit-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Arenukvern/mcp_flutter flutter-mcp-toolkit-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Arenukvern/mcp_flutter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/flutter-mcp-toolkit-guide .claude/skills/flutter-mcp-toolkit-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
flutter-mcp-toolkit-guide
GitHub stars
386
Token cost
~1.3k tokens
SKILL.md length
521 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to the right task skill (inspect / control / debug / custom app surfaces) and runs preflight.

  • Works in 3 steps: Preflight → Pick the right skill for the user's intent → Execute
  • Tasks that involve Cross-platform mobile apps
  • SKILL.md covers When to use, Step 1: Preflight, Step 2: Pick the right skill… and Step 3: Execute, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Flutter MCP Toolkit Guide is an agent skill from Arenukvern/mcp_flutter. Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to the right task skill (inspect / control / debug / custom app surfaces) and runs preflight.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Cross-platform mobile apps and MCP servers. It works with Flutter and Model Context Protocol. The repository describes itself as: MCP Toolkit for Flutter AI Agent Driven Development (MCP/CLI + custom client side tools) - via closed feedback loop (visual & semantic snapshot) and high client side… The licence is MIT.

When your agent uses it

  • Tasks that involve Cross-platform mobile apps
  • Tasks that involve MCP servers

Example prompts

  • “/flutter-mcp-toolkit-guide”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Preflight
  2. Pick the right skill for the user's intent
  3. Execute

What it can do on your machine

Read from SKILL.md and the folder at commit 62f3ee1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Flutter MCP Toolkit Guide loads about 1.3k tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 521 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Arenukvern/mcp_flutter at commit 62f3ee1, republished under its MIT licence (© Arenukvern). 521 words, ~1,314 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-mcp-toolkit-guide/SKILL.md (or your agent's skills folder).
name
flutter-mcp-toolkit-guide
description
Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to the right task skill (inspect / control / debug / custom app surfaces) and runs preflight.
<!-- @FMT_MODE_PRELUDE -->

When to use

Use this skill when the user wants to inspect or drive a running Flutter app from this conversation. Examples:

  • "Tap the login button in my app"
  • "Why is the home screen blank?"
  • "Take a screenshot and tell me what's broken"
  • "Expose my cart / flags / internal state to the agent via MCP"

If the user is asking about Flutter concepts unrelated to a running app (architecture questions, package selection), this skill does not apply.

Step 1: Preflight

Always run flutter-mcp-toolkit doctor --json first. Parse the output:

  • status: "ok" — proceed to Step 2.
  • status: "error" and error.code: "binary_not_found" — load flutter-mcp-toolkit-setup and follow its install instructions.
  • status: "error" and error.code: "vm_not_connected" — load flutter-mcp-toolkit-setup and follow its troubleshooting section.
  • Any other error — load flutter-mcp-toolkit-debug and read the error envelope playbook.

Step 2: Pick the right skill for the user's intent

User intentLoad skill
Read state ("what's on screen?", "show me errors", "screenshot")flutter-mcp-toolkit-inspect
Drive UI ("tap X", "type into Y", "scroll to Z", "hot reload")flutter-mcp-toolkit-control
Diagnose ("why is X failing?", "show recent logs", "evaluate expression")flutter-mcp-toolkit-debug
Register app-specific MCP tools/resources (AgentCallEntry, addEntries)flutter-mcp-toolkit-custom-tools
Upgrade from removed legacy call-entry APIsflutter-mcp-toolkit-intentcall-migration
Audit CLI/MCP/schema/dynamic-registry parity before changing tool surfacesflutter-mcp-boundary-audit
Maintain showcase/flutter_test_app web / WebMCP showcase hooks; agent list/execute via Chrome DevTools MCP (list_webmcp_tools / execute_webmcp_tool)flutter-mcp-toolkit-maintain-web
Maintain showcase/flutter_test_app macOS / native IntentCall hooksflutter-mcp-toolkit-maintain-macos
Score dogfood iterations or route dogfood evidenceflutter-mcp-toolkit-dogfood-iterations
Write repeatable E2E scenarios as Dart (flutter_mcp_harness: build/launch/attach/drive/assert, showcase launcher)flutter-mcp-e2e-harness
Wire automation for an app across surfaces (MCP / CLI / harness / oka), first loops, runner sessionsflutter-mcp-automation-chain
Release, version, or plugin skill bundle maintenanceflutter-mcp-toolkit-repo-maintainer

Harness Script lint/run/Maestro and promo/video capture live in their owner repositories. Do not look for flutter-mcp-semantic-test, flutter-mcp-capture, or hyperframes-video in this plugin.

If the task spans more than one (e.g. "tap the button and show me what changed"), load inspect AND control. Skills are additive.

Show full SKILL.md (212 more words)Show less

Step 3: Execute

Each task skill has the tool list, parameter shapes, and example calls. Follow the prelude at the top of the skill — it tells you whether you're calling MCP tools or shelling out to the CLI.

Tool taxonomy reference

The core toolkit tools fall into these categories. The full list with parameter shapes lives in the task skills.

  • Inspection (read-only): discover_debug_apps, get_app_errors, get_screenshots, get_view_details, get_vm, get_extension_rpcs, semantic_snapshot, inspect_widget_at_point, capture_ui_snapshot, connect_debug_app. → flutter-mcp-toolkit-inspect.
  • Interaction (mutating): tap_widget, long_press, enter_text, reveal_search, fill_form, scroll, swipe, drag, hover, focus_widget, press_key, wait_for, navigate, handle_dialog, hot_reload_flutter, hot_restart_flutter, hot_reload_and_capture. → flutter-mcp-toolkit-control.
  • Debug: get_recent_logs, evaluate_dart_expression. → flutter-mcp-toolkit-debug.
  • Dynamic registry (app-defined): after registration in the Flutter app, MCP calls use fmt_list_client_tools_and_resources, then fmt_client_tool / fmt_client_resource. When shelling out to the CLI, command names appear only as exec --name <name> values; do not call bare list_client_tools_and_resources, client_tool, or client_resource as MCP tools. → flutter-mcp-toolkit-custom-tools.
  • Boundary/proof maintenance: use flutter-mcp-boundary-audit before changing catalog/schema/registry surfaces; use flutter-mcp-toolkit-maintain-web or flutter-mcp-toolkit-maintain-macos for showcase platform hooks; use flutter-mcp-toolkit-repo-maintainer for release, version, and generated skill-bundle work.
  • True WebMCP (browser): with Chrome DevTools MCP (--categoryExperimentalWebmcp), use list_webmcp_tools / execute_webmcp_tool after navigating to the web app. Details in flutter-mcp-toolkit-maintain-web.

When in doubt

If doctor is green but a tool call fails, read the returned error.code and error.recovery fields. The full code → recovery table is in flutter-mcp-toolkit-debug.

© Arenukvern, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugin/skills/flutter-mcp-toolkit-guide of Arenukvern/mcp_flutter.

Open the folder on GitHubat commit 62f3ee1

Compare with similar skills

Flutter MCP Toolkit Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Flutter MCP Toolkit Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter MCP Toolkit Guide this skillArenukvern/mcp_flutter386—~1.3kAutomated safety check: PassMIT
Retrieving Developer Knowledgegoogle/skills21k—~2kAutomated safety check: PassApache-2.0
MCP Dart Clientleehack/mcp_dart116—~1.8kAutomated safety check: PassMIT
Appllama UsageAppllama/appllama-skills2.5k1 repos~1.6kAutomated safety check: PassMIT
Marionette Flutter Drive Appleancodepl/marionette_mcp482—~11kAutomated safety check: PassApache-2.0
Aaalice Dev SessionsAaalice233/Aaalice_NAI_Launcher188—~902Automated safety check: PassMIT

Similar skills

  • Official

    Searches, retrieves, and synthesizes official Google developer documentation across Google Cloud, AI/Gemini, Android, Chrome, Web, Flutter, Go, Firebase, and other Google developer platforms.

    21k GitHub stars~2k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • MCP Dart Client

    leehack/mcp_dart

    A skill your agent uses when connecting a Dart or Flutter app to a Model Context Protocol (MCP) server with mcpdart: creating an McpClient, launching a local server over stdio or reaching a remote…

    116 GitHub stars~1.8k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Appllama Usage

    Appllama/appllama-skills

    Use the Appllama MCP (mcp.appllama.io) well — research real top-grossing mobile apps, their screens, flows, and UI elements, then build from what you learn.

    2.5k GitHub starsUsed in 1 repo~1.6k tokens
    MobileAuto-check passed
  • Marionette Flutter Drive App

    leancodepl/marionette_mcp

    Set up and drive a running Flutter app (debug or profile) with Marionette — an AI agent's hands and eyes for the app.

    482 GitHub stars~11k tokensUpdated 4 days ago
    MobileAuto-check passed
  • Aaalice Dev Sessions

    Aaalice233/Aaalice_NAI_Launcher

    管理 Aaalice NAI Launcher 项目专用的 Windows 与 Android Flutter 开发会话。用户提到 PC热重载、安卓热重载、启动/关闭/重建独立命令行窗口、模拟器启动异常或检查双端会话时使用。

    188 GitHub stars~902 tokensUpdated 4 days ago
    MobileAuto-check passed
  • AI App Bridge Use

    mobileAiDev/ai-app-bridge

    使用 AI App Bridge 观察、操作和验证 Android、iOS、Flutter、WebView 或 Web App;适用于真实交互、流程自动化和设备诊断。

    227 GitHub stars~1.4k tokensUpdated yesterday
    MobileAuto-check passed

More from Arenukvern/mcp_flutter

All 23 skills in this repo
  • Harness Engineering Lifecycle

    Arenukvern/mcp_flutter

    Design, implement, and integrate generalized validation harnesses across a producer-consumer boundary after a local harness contract exists.

    386 GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check passed
  • Mixture Of Experts

    Arenukvern/mcp_flutter

    Run a Mixture of Experts (MoE) audit on any topic, plan, codebase, evidence archive, or process.

    386 GitHub stars~2.3k tokensUpdated 6 days ago
    Auto-check passed
  • Multi Agent Handoff

    Arenukvern/mcp_flutter

    Plan and document handoffs, parent lane contracts, and parallel batch contracts between specialized AI agents (foreman, workers, reviewers).

    386 GitHub stars~2.7k tokensUpdated 6 days ago
    Auto-check passed
  • Plugin Marketplace Setup

    Arenukvern/mcp_flutter

    Designs public or private Agent Skill and plugin marketplaces for Cursor, Claude Code, Codex, Zed, Open Plugin, and npx skills—manifest layout, install matrix, and Skill Steward vs product boundaries.

    386 GitHub stars~2.9k tokensUpdated 6 days ago
    Auto-check passed
  • Release Changelog Harness

    Arenukvern/mcp_flutter

    Chooses ecosystem-native release and changelog tooling (Changesets, Melos, release-plz) plus binary distribution (GitHub Release tarballs, install.sh) when the product is an executable.

    386 GitHub stars~2.6k tokensUpdated 6 days ago
    Auto-check passed
  • Repository Governance Lifecycle

    Arenukvern/mcp_flutter

    Master orchestration for repository governance, North Star impact, sub-Star boundaries, and repair-first or evidence-first drift checks.

    386 GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed

Categories

Questions about Flutter MCP Toolkit Guide

What does Flutter MCP Toolkit Guide do?

Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to the right task skill (inspect / control / debug / custom app surfaces) and runs preflight. Flutter MCP Toolkit Guide is an agent skill from Arenukvern/mcp_flutter. Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to the right task skill (inspect / control / debug / custom app surfaces) and runs preflight.

When should I use Flutter MCP Toolkit Guide?

Flutter MCP Toolkit Guide fits situations like: tasks that involve Cross-platform mobile apps; tasks that involve MCP servers.

How do I install Flutter MCP Toolkit Guide in Claude Code?

Run `npx skills add Arenukvern/mcp_flutter --skill flutter-mcp-toolkit-guide -a claude-code`. Or copy the skill folder (plugin/skills/flutter-mcp-toolkit-guide in Arenukvern/mcp_flutter) into .claude/skills/flutter-mcp-toolkit-guide in your project. Claude Code loads it when a task matches its description.

How do I install Flutter MCP Toolkit Guide in Codex?

Run `npx skills add Arenukvern/mcp_flutter --skill flutter-mcp-toolkit-guide -a codex`. Or copy the skill folder (plugin/skills/flutter-mcp-toolkit-guide in Arenukvern/mcp_flutter) into .agents/skills/flutter-mcp-toolkit-guide in your project. Codex loads it when a task matches its description.

Can I use Flutter MCP Toolkit Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Arenukvern/mcp_flutter --skill flutter-mcp-toolkit-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flutter-mcp-toolkit-guide, .gemini/skills/flutter-mcp-toolkit-guide, .github/skills/flutter-mcp-toolkit-guide and .opencode/skills/flutter-mcp-toolkit-guide in your project.

What does Flutter MCP Toolkit Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Flutter MCP Toolkit Guide is instructions for the agent only.

Does Flutter MCP Toolkit Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Flutter MCP Toolkit Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Flutter MCP Toolkit Guide use?

Flutter MCP Toolkit Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flutter MCP Toolkit Guide use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Flutter MCP Toolkit Guide?

Skills that share tags, products or a category with Flutter MCP Toolkit Guide: Retrieving Developer Knowledge (google/skills, 21k stars), MCP Dart Client (leehack/mcp_dart, 116 stars), Appllama Usage (Appllama/appllama-skills, 2.5k stars) and Marionette Flutter Drive App (leancodepl/marionette_mcp, 482 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter MCP Toolkit Guide?

Arenukvern (a GitHub user) maintains it in Arenukvern/mcp_flutter, which has 386 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 3, 2026.

Source: Arenukvern/mcp_flutter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.