AI Agent Setup

flutter-mcp-toolkit ships eight agent skills (task guides + runtime golden path + CLI validation). Canonical source: plugin/skills/ (also exposed at repo root as skills/ for npx skills discovery).

Three layers (read this first)

1. Host MCP — flutter-mcp-toolkit-server with 27 fmt_* tools.
2. In-app toolkit — mcp_toolkit in your Flutter app (debug only).
3. Dynamic registry — register custom tools/resources at runtime (addMcpTool, MCPCallEntry). Agents discover via fmt_list_client_tools_and_resources and invoke via fmt_client_tool / fmt_client_resource. Use skill flutter-mcp-toolkit-custom-tools and Dynamic tool registry.

Skills alone do not replace the MCP server or in-app toolkit.

Install methods (pick one)

Skills teach the agent how to use the toolkit. You still need the MCP server binary and mcp_toolkit in your Flutter app — see Get started steps 1–2 and 4.

Full matrix: Marketplace distribution. Store submission: runbook.

init all installs for claude-code, cursor, codex, and cline only. For the cross-agent .agents/skills/ layout, use init agents-skills or npx skills.

Install for your agent (flutter-mcp-toolkit init)

flutter-mcp-toolkit init claude-code   # or: cursor | codex | cline | agents-skills | all

This writes skills + plugin manifest + MCP server registration to the agent's expected path. The init command auto-detects MCP vs CLI mode; override with --mode mcp|cli|auto.

flutter-mcp-toolkit init cursor --scope user   # user-global Cursor plugin
flutter-mcp-toolkit init agents-skills -y      # .agents/skills/ (Cursor, Cline, Codex, Copilot, …)

Per-target output paths

Install via npx skills (open agent skills ecosystem)

The skills CLI (Vercel vercel-labs/skills) installs SKILL.md bundles from this GitHub repo into your agent's skills directory. It does not register the MCP server — run flutter-mcp-toolkit init <agent> afterward if you need mcp.json, or add mcpServers manually (mcp_server_dart/README).

# Preview all skills in this repo
npx skills add Arenukvern/mcp_flutter --list

# Install the entry + setup skills for Cursor (project scope)
npx skills add Arenukvern/mcp_flutter \
  --skill flutter-mcp-toolkit-guide \
  --skill flutter-mcp-toolkit-setup \
  -a cursor -y

# Install all skills for Claude Code (global)
npx skills add Arenukvern/mcp_flutter -g -a claude-code -y

# Cross-agent layout (.agents/skills/) — same tree as `init agents-skills`
npx skills add Arenukvern/mcp_flutter -a cursor -a cline -y

Discover more community skills at skills.sh. Pin the CLI in CI with npx skills@latest if needed.

Team lockfile (reproducible installs)

After the first npx skills add, the CLI writes .skills.json and skills-lock.json. Commit those in your app repo so everyone gets the same skill versions.

Example manifest (copy from .skills.json.example or generate via install):

{
  "skills": [
    {
      "name": "flutter-mcp-toolkit-guide",
      "remote": "Arenukvern/mcp_flutter",
      "version": "latest"
    }
  ]
}

CI restore (experimental API — check skills CLI README for current command names):

- name: Restore AI agent skills
  run: npx skills@latest experimental_install

Claude Code marketplace

# Git catalog (works today)
/plugin marketplace add Arenukvern/mcp_flutter
/plugin install flutter-mcp-toolkit@Arenukvern-mcp_flutter

# Prerequisite check
bash plugin/install.sh   # after server binary is on PATH or FLUTTER_MCP_BIN is set

Marketplace entry: .claude-plugin/marketplace.json → ./plugin.

Official Anthropic catalog: platform.claude.com/plugins/submit — see submission runbook.

Cursor and Codex

flutter-mcp-toolkit init cursor
flutter-mcp-toolkit init codex
# or:
codex plugin marketplace add Arenukvern/mcp_flutter

See Marketplace distribution for Smithery, MseeP, and asset requirements.

Browse the skills

Skills are plain Markdown — readable without an agent. Edit under plugin/skills/<id>/SKILL.md, then run make sync-skills before committing (regenerates the embedded bundle in mcp_server_dart).