Agent skill

Flutter MCP Toolkit Custom Tools

by Arenukvern in Arenukvern/mcp_flutter

A skill your agent uses when the agent exposes app-specific surfaces by registering custom MCP tools and resources inside the Flutter app (mcptoolkit dynamic registry — AgentCallEntry, addEntries).

MITAuto-check passedMobile

Install Flutter MCP Toolkit Custom Tools

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

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

GitHub CLI
$ gh skill install Arenukvern/mcp_flutter flutter-mcp-toolkit-custom-tools --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-custom-tools .claude/skills/flutter-mcp-toolkit-custom-tools && 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-custom-tools
GitHub stars
387
Token cost
~1.9k tokens
SKILL.md length
545 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the agent exposes app-specific surfaces by registering custom MCP tools and resources inside the Flutter app (mcptoolkit dynamic registry — AgentCallEntry, addEntries).

  • Works in 3 steps: fmt_list_client_tools_and_resources —… → fmt_client_tool — invoke a dynamic tool… → fmt_client_resource — fetch a registered…
  • Tasks that involve MCP servers
  • SKILL.md covers Pick the right primitive, Handler signatures, Custom resources and Schema rules (tools), plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Flutter MCP Toolkit Custom Tools is an agent skill from Arenukvern/mcp_flutter. Use this skill when the agent exposes app-specific surfaces by registering custom MCP tools and resources inside the Flutter app (mcptoolkit dynamic registry — AgentCallEntry, addEntries). Covers tool vs resource vs evaluate-expression, Map-based handlers, schema strictness, discovery via fmtlistclienttoolsandresources, fmtclienttool, fmtclientresource, and lifecycle pitfalls.

Its SKILL.md is about 1.9k 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 MCP servers and Cross-platform mobile apps. It works with Model Context Protocol and Flutter. 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 MCP servers
  • Tasks that involve Cross-platform mobile apps

Example prompts

  • “/flutter-mcp-toolkit-custom-tools”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. fmt_list_client_tools_and_resources — enumerate app-registered tools and resources.
  2. fmt_client_tool — invoke a dynamic tool by name with JSON args.
  3. fmt_client_resource — fetch a registered resource URI from the listing.

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 (its code samples are dart).

    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 Custom Tools loads about 1.9k tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 545 words of instructions outside code blocks.

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

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). 545 words, ~1,873 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-mcp-toolkit-custom-tools/SKILL.md (or your agent's skills folder).
name
flutter-mcp-toolkit-custom-tools
description
Use this skill when the agent exposes app-specific surfaces by registering custom MCP tools and resources inside the Flutter app (mcp_toolkit dynamic registry — AgentCallEntry, addEntries). Covers tool vs resource vs evaluate-expression, Map-based handlers, schema strictness, discovery via fmt_list_client_tools_and_resources, fmt_client_tool, fmt_client_resource, and lifecycle pitfalls.
<!-- @FMT_MODE_PRELUDE -->

Custom MCP Toolkit Tools & Resources (Dynamic Registry)

Use this when bundled MCP tools (screenshot, semantic snapshot, tap, …) are not enough and you need app-specific read surfaces or actions — e.g. cart totals, feature flags, curated debug snapshots of internal state. Entries are registered in the Flutter process and exposed to the agent through the dynamic registry.

Migration: The legacy call-entry type was removed in intentcall Phase 6b. Use AgentCallEntry or mcpToolkitTool / mcpToolkitResource. See flutter-mcp-toolkit-intentcall-migration.

Boundary: Change app discovery, Flutter VM-service extensions, or app-owned debug surfaces here. Change canonical registry/session semantics, schema policy, platform projection, or publish behavior in the upstream IntentCall repository.

Pick the right primitive

NeedUse
One-off read of a simple valuefmt_evaluate_dart_expression (no app code change).
Stable read-only payload (diagnostics, JSON snapshot, “current route”)AgentCallEntry.resource + fmt_client_resource. Prefer resources when the contract is “GET-like” and idempotent.
Parameterized or mutating action, or reusable named operationAgentCallEntry.tool + fmt_client_tool.

Handler signatures

Native AgentCallEntry (preferred for new code)

Handlers receive AgentArguments (Map<String, Object?>) and return AgentResult:

dart
import 'package:mcp_toolkit/mcp_toolkit.dart';

final tool = AgentCallEntry.tool(
  namespace: 'app',
  name: 'cart_get_snapshot',
  description: 'Return current cart total and items for a user.',
  inputSchema: const {
    'type': 'object',
    'additionalProperties': false,
    'properties': {
      'userId': {'type': 'string'},
    },
    'required': ['userId'],
  },
  handler: (final args) async {
    final userId = args['userId']?.toString() ?? '';
    final cart = CartRepository.instance.forUser(userId);
    return AgentResult.success(
      message: 'ok',
      data: {
        'total': cart.total,
        'items': cart.items.map((final i) => i.toJson()).toList(),
      },
    );
  },
);

await MCPToolkitBinding.instance.addEntries(entries: {tool});
Legacy MCPToolDefinition + MCPCallResult (bridge)

Built-in toolkits still use mcpToolkitTool / mcpToolkitResource to adapt Map<String, String> service-extension handlers:

dart
final tool = mcpToolkitTool(
  namespace: 'app',
  handler: (final request) async {
    final userId = request['userId'] ?? '';
    return MCPCallResult(
      message: 'ok',
      parameters: {'userId': userId},
    );
  },
  definition: MCPToolDefinition(
    name: 'cart_get_snapshot',
    description: 'Return current cart total and items for a user.',
    inputSchema: ObjectSchema(
      properties: {
        'userId': StringSchema(),
      },
      required: ['userId'],
    ),
  ),
);
  • Tool arguments on the wire are strings keyed by schema property names — parse with int.tryParse, jsonDecode, etc.
  • Do not use request.arguments on the app side.

Prefer MCPToolkitBinding.instance.addEntries(entries: { ... }) before bootstrapFlutter(runApp: ...) so tools/resources register in one place with zone/error setup.

Register once at bootstrap — not inside build, not per-widget initState.

Custom resources

dart
final resource = AgentCallEntry.resource(
  namespace: 'app',
  name: 'app_cart_digest',
  description: 'Compact cart summary for agents (read-only).',
  mimeType: 'application/json',
  handler: (final args) async => AgentResult.success(
    message: 'Cart digest',
    data: {
      'itemCount': CartRepository.instance.visibleCount,
      'currency': CartRepository.instance.currencyCode,
    },
  ),
);

Or via bridge:

dart
mcpToolkitResource(
  namespace: 'app',
  definition: MCPResourceDefinition(
    name: 'app_cart_digest',
    description: 'Compact cart summary for agents (read-only).',
    mimeType: 'application/json',
  ),
  handler: (final request) async => MCPCallResult(
    message: 'Cart digest',
    parameters: {'itemCount': 3},
  ),
),
  • name must be snake_case. Published resource URIs follow visual://localhost/... conventions; agents use fmt_client_resource and listings from fmt_list_client_tools_and_resources.

Schema rules (tools)

The MCP server enforces strict JSON Schema:

  • Prefer additionalProperties: false unless you intentionally accept arbitrary keys.
  • Mark required for anything the handler reads unconditionally.
  • AgentResult.data / MCPCallResult.parameters must be JSON-serializable.

Discovery from the agent side

  1. fmt_list_client_tools_and_resources — enumerate app-registered tools and resources.
  2. fmt_client_tool — invoke a dynamic tool by name with JSON args.
  3. fmt_client_resource — fetch a registered resource URI from the listing.

If something should appear but does not: confirm addEntries completed (await), then hot restart.

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

Lifecycle gotchas

  • Hot reload + addEntries from widget code → duplicate registrations. Register once in main() / bootstrap.
  • Debug mode only — release builds do not expose VM service extensions.
  • Naming: the app uses a flat global namespace. Prefix tools/resources (cart_, flags_, nav_). If a built-in entry already uses a name, the custom entry is skipped without warning; the built-in handles the call and the custom handler does not run.
  • Naming the running instance is MCPToolkitBinding.instance.setAppIdentity(label: 'Fleet app · staging'), called again whenever the name changes (sign-in, workspace switch). Discovery reads that label, and a tool of your own called app_identity is one of the collisions above.

When the agent authors surfaces for the user’s app

  1. Ensure mcp_toolkit is in pubspec.yaml.
  2. Add lib/mcp_tools/<domain>_surfaces.dart returning Set<AgentCallEntry> or calling addEntries once.
  3. Wire from addEntries(...) before bootstrapFlutter(...) — never from StatefulWidget lifecycle.
  4. Tight schemas; hot restart; then fmt_list_client_tools_and_resources before first client invoke.

Safety and scope

  • Treat handlers as powerful debug hooks: avoid secrets, unchecked IO.
  • Keep handlers thin: delegate to existing app services.

Common traps

  • Mixing AgentArguments with Map<String, String> — pick one API (native vs mcpToolkitTool).
  • Missing await on addEntries → race before discovery.
  • inputSchema out of sync with the handler → agents trust the schema; update both.
  • flutter-mcp-toolkit-intentcall-migration — CLI migrator, breaking upgrade
  • flutter-mcp-toolkit-guide → inspect / control / debug skills
  • Repository ARCHITECTURE.md → “Dynamic Registry Architecture”

© 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-custom-tools of Arenukvern/mcp_flutter.

Open the folder on GitHubat commit 62f3ee1

Compare with similar skills

Flutter MCP Toolkit Custom Tools 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 Custom Tools compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter MCP Toolkit Custom Tools this skillArenukvern/mcp_flutter387—~1.9kAutomated safety check: PassMIT
MCP Debuggerdebugmcp/mcp-debugger173—~4.1kAutomated 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

Similar skills

  • MCP Debugger

    debugmcp/mcp-debugger

    A skill your agent uses when investigating a bug, failing test, or unexpected runtime behavior and the mcp-debugger MCP server is available — drives real step-through debuggers (breakpoints, stack…

    173 GitHub stars~4.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • 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 5 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 5 days ago
    MobileAuto-check passed
  • Aaalice Dev Sessions

    Aaalice233/Aaalice_NAI_Launcher

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

    188 GitHub stars~902 tokensUpdated 5 days ago
    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.

    387 GitHub stars~1.6k tokensUpdated 7 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.

    387 GitHub stars~2.3k tokensUpdated 7 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).

    387 GitHub stars~2.7k tokensUpdated 7 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.

    387 GitHub stars~2.9k tokensUpdated 7 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.

    387 GitHub stars~2.6k tokensUpdated 7 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.

    387 GitHub stars~1.5k tokensUpdated 7 days ago
    Auto-check passed

Categories

Questions about Flutter MCP Toolkit Custom Tools

What does Flutter MCP Toolkit Custom Tools do?

A skill your agent uses when the agent exposes app-specific surfaces by registering custom MCP tools and resources inside the Flutter app (mcptoolkit dynamic registry — AgentCallEntry, addEntries). Flutter MCP Toolkit Custom Tools is an agent skill from Arenukvern/mcp_flutter. Use this skill when the agent exposes app-specific surfaces by registering custom MCP tools and resources inside the Flutter app (mcptoolkit dynamic registry — AgentCallEntry, addEntries).

When should I use Flutter MCP Toolkit Custom Tools?

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

How do I install Flutter MCP Toolkit Custom Tools in Claude Code?

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

How do I install Flutter MCP Toolkit Custom Tools in Codex?

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

Can I use Flutter MCP Toolkit Custom Tools 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-custom-tools -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-custom-tools, .gemini/skills/flutter-mcp-toolkit-custom-tools, .github/skills/flutter-mcp-toolkit-custom-tools and .opencode/skills/flutter-mcp-toolkit-custom-tools in your project.

What does Flutter MCP Toolkit Custom Tools need to run?

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

Does Flutter MCP Toolkit Custom Tools 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 Custom Tools 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 Custom Tools use?

Flutter MCP Toolkit Custom Tools 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 Custom Tools use?

About 1.9k tokens (SKILL.md is roughly 7.5k 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 Custom Tools?

Skills that share tags, products or a category with Flutter MCP Toolkit Custom Tools: MCP Debugger (debugmcp/mcp-debugger, 173 stars), Retrieving Developer Knowledge (google/skills, 21k stars), MCP Dart Client (leehack/mcp_dart, 116 stars) and Appllama Usage (Appllama/appllama-skills, 2.5k 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 Custom Tools?

Arenukvern (a GitHub user) maintains it in Arenukvern/mcp_flutter, which has 387 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.