FlutterSDK Docs

Official1 toolLive

by fluttersdk · Shell

Search Wind UI, Magic, Dusk, Telescope and Artisan documentation. Hosted, public, no auth.

MCP Server: io.github.fluttersdk/ai

This MCP server provides search over Wind UI, Magic, Dusk, Telescope, and Artisan documentation. It is hosted as a public service and requires no authentication. Server metadata is associated with the io.github.fluttersdk/ai identifier.

🛠️ Key Features

Publicly hosted
No authentication required
Documentation search for: Wind UI, Magic, Dusk, Telescope, Artisan

🚀 Use Cases

Find relevant documentation content for supported products/frameworks
Integrate documentation lookup into developer workflows via MCP

⚡ Developer Benefits

Uses a single server entry: io.github.fluttersdk/ai
Supports topics including flutter, magic-framework, skills, and wind-ui (as provided)

⚠️ Limitations

Only documentation search is indicated; no other capabilities are described
No tool count or API methods are provided in the available data

Topics

fluttermagic-frameworkskillswind-ui

Captured live from the server via tools/list.

search-docs

Search FlutterSDK package documentation (artisan, dusk, magic, telescope, wind). Returns markdown results with full page content up to a token budget. Default: search all packages at their latest version.

Parameters4

queries	array	optional	List of search queries. Pass multiple when terminology is ambiguous (e.g. ['toggle', 'switch']). Required.
packages	array	optional	Optional package filter. Slugs (artisan, dusk, magic, telescope, wind) or composer-style (fluttersdk_wind). Default: all 5.
version	string	optional	Optional version pin, applied to both the pages found and the content served. Default: latest per package. On a miss the series chain falls back and the response header names what was requested.
token_limit	integer	optional	Token budget for response. Default 3000, max 100000. Approx chars = tokens × 4.

Raw schema

{
  "type": "object",
  "properties": {
    "queries": {
      "description": "List of search queries. Pass multiple when terminology is ambiguous (e.g. ['toggle', 'switch']). Required.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "packages": {
      "description": "Optional package filter. Slugs (artisan, dusk, magic, telescope, wind) or composer-style (fluttersdk_wind). Default: all 5.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "version": {
      "description": "Optional version pin, applied to both the pages found and the content served. Default: latest per package. On a miss the series chain falls back and the response header names what was requested.",
      "type": "string"
    },
    "token_limit": {
      "description": "Token budget for response. Default 3000, max 100000. Approx chars = tokens × 4.",
      "default": 3000,
      "type": "integer"
    }
  }
}

README.md8 KBView on GitHub

FlutterSDK AI Logo

FlutterSDK AI

AI coding skills for the FlutterSDK ecosystem.
Teach your AI assistant Wind UI, Magic Framework, and more, across every major coding tool.

Registry · Issues · Quick Start

Why?

AI coding assistants are powerful, but they don't know your frameworks. They hallucinate widget names, guess at API patterns, and miss conventions.

FlutterSDK AI fixes this. It gives your AI structured knowledge about Wind UI's className system, Magic Framework's Laravel-inspired architecture, and more, so it generates correct code on the first try.

One install, every tool:

Tool	Integration
OpenCode	URL-based skill registry
Claude Code	Plugin + Marketplace
Cursor	Rules (`.mdc`)
Gemini CLI	Command templates (`.toml`)
VS Code Copilot	Instructions (`.md`)
Codex CLI	MCP config (`~/.codex/config.toml`)
Antigravity CLI	MCP config (`~/.gemini/config/mcp_config.json`)
Cline	MCP config (`.mcp.json`)
Roo Code	MCP config (`.mcp.json`)

Skills

Five skills are available. See docs/SKILLS.md for full descriptions.

Skill	Package	Upstream	What it covers
`wind-ui`	`fluttersdk_wind`	fluttersdk/wind	W-prefix widgets, the `className` parser pipeline, `WindRecipe` variants, dark mode, responsive breakpoints, design culture
`magic-framework`	`magic`	fluttersdk/magic	IoC container, 18 facades, Eloquent ORM, GoRouter routing, forms, auth, testing, 5 ecosystem plugins
`fluttersdk-dusk`	`fluttersdk_dusk`	fluttersdk/dusk	E2E driver: `dusk_*` MCP tools and matching CLI commands to snap, tap, type, and screenshot a running Flutter app
`fluttersdk-telescope`	`fluttersdk_telescope`	fluttersdk/telescope	Runtime inspector: 9 ring buffers for HTTP, logs, exceptions, events, gates, DB queries
`fluttersdk-artisan`	`fluttersdk_artisan`	fluttersdk/artisan	CLI framework + stdio MCP server: substrate `artisan_*` tools, builtin commands, `artisan_tinker`

Each skill mirrors its upstream package's own skills/ directory and arrives here when that package publishes a release. The exact synced version is the version: field in skills/<name>/SKILL.md, and skills/index.json is the machine-readable index; neither is duplicated in this table, so neither can drift from it.

MCP Server

mcp.fluttersdk.com exposes a single search-docs tool via Streamable HTTP. Public, no auth required. Full client config snippets (Claude Code, Cursor, OpenCode, Codex CLI, Gemini CLI, VS Code Copilot, and more) are in docs/MCP.md.

For clients that only support stdio (Claude Desktop, older Codex CLI):

bash

npx @fluttersdk/mcp

The npx bridge proxies stdio to the upstream HTTP server transparently.

Quick Start

Option 1: `npx skills` (Recommended)

The fastest way. Works with 40+ AI coding agents.

bash

# Install all FlutterSDK skills to all detected agents
npx skills add fluttersdk/ai

# Install a specific skill
npx skills add fluttersdk/ai --skill wind-ui

# Install globally (available across all projects)
npx skills add fluttersdk/ai -g

Option 2: Universal Installer

bash

git clone https://github.com/fluttersdk/ai.git && cd ai

# Preview what would be installed
bash scripts/install.sh --dry-run --global

# Install globally for all detected tools
bash scripts/install.sh --global

# Install globally and register the MCP server for all detected tools
bash scripts/install.sh --global --with-mcp

# Or install into your current Flutter project
bash scripts/install.sh --project

Option 3: Tool-Specific

OpenCode

Add the registry URL to your opencode.json:

json

{
    "skills": {
        "urls": ["https://fluttersdk.github.io/ai/"]
    }
}

Skills are fetched automatically and cached locally.

Claude Code

bash

/plugin marketplace add https://raw.githubusercontent.com/fluttersdk/ai/main/.claude-plugin/marketplace.json
/plugin install fluttersdk@fluttersdk-marketplace

The plugin auto-registers:

5 skills (/fluttersdk:wind-ui, /fluttersdk:magic-framework, /fluttersdk:fluttersdk-dusk, /fluttersdk:fluttersdk-telescope, /fluttersdk:fluttersdk-artisan)
/fluttersdk:flutter-review, a review that runs in a subagent as an independent second pair of eyes and then fixes what it finds, plus /fluttersdk:flutter-test
fluttersdk:flutter-reviewer and fluttersdk:flutter-reviewer-deep subagents, invokable directly with @
fluttersdk MCP server (HTTP transport to mcp.fluttersdk.com; no manual .mcp.json edit required)

Cursor

bash

mkdir -p .cursor/rules
cp tool-templates/cursor/fluttersdk.mdc .cursor/rules/

Activates automatically for all .dart files.

Gemini CLI

bash

mkdir -p ~/.gemini/commands
cp tool-templates/gemini/*.toml ~/.gemini/commands/

Use with /flutter-review and /flutter-test commands.

VS Code Copilot

bash

mkdir -p .github
cp .github/copilot-instructions.md .github/

How It Works

code

skills/index.json              ← OpenCode fetches this from GitHub Pages
  → wind-ui/SKILL.md           ← Skill definition + className rules
  → wind-ui/references/*.md    ← On-demand widget docs, layout patterns, tokens
  → magic-framework/SKILL.md   ← Skill definition + framework laws
  → magic-framework/refs/*.md  ← Controllers, ORM, facades, routing, auth, ...

OpenCode: Fetches fluttersdk.github.io/ai/index.json, downloads listed skill files, caches locally.

Claude Code: Plugin manifest (.claude-plugin/plugin.json) makes the repo installable. Skills in skills/ are auto-discovered and namespaced under /fluttersdk:.

Deployment: Push to main → GitHub Actions deploys skills/ to GitHub Pages automatically.

Contributing

Adding a New Skill

Create skills/<skill-name>/SKILL.md with YAML frontmatter (name, description)
Add reference files in skills/<skill-name>/references/
Update skills/index.json: list every file in the files array
Bump version in .claude-plugin/plugin.json and .claude-plugin/marketplace.json
Push to main

See CLAUDE.md for the full specification.

Important: Every file must be listed in index.json: OpenCode only downloads listed files. Forgetting a file means users get incomplete skills.

License

MIT. See LICENSE for details.

_{Built with care by FlutterSDK}
_{If this saves you time, give it a star; it helps others discover it.}

Install

Tools (1)

search-docs

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ai": {
      "command": "npx",
      "args": [
        "-y",
        "@fluttersdk/mcp@1.1.3"
      ]
    }
  }
}

MCP Server: io.github.fluttersdk/ai

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search-docs

FlutterSDK AI

Why?

Skills

MCP Server

Quick Start

Option 1: npx skills (Recommended)

Option 2: Universal Installer

Option 3: Tool-Specific

How It Works

Contributing

Adding a New Skill

License

Install

Related servers

Option 1: `npx skills` (Recommended)