flutter-orchestrator
This server is an MCP toolset for end-to-end Flutter/Dart app development, from prompt decomposition and architecture planning to code generation, testing, auditing, and CI/CD.
Generate project blueprints and documentation (PRD, architecture, design, rules, phases, memory).
Decompose prompts into Clean Architecture features, sprints, and target-platform specifications.
Research pub.dev dependencies and generate pubspec.yaml / analysis_options.yaml.
Design responsive Material 3 Flutter UI screens with Riverpod/Bloc state integration.
Scaffold backend layers, REST/Supabase data sources, Drift/Hive databases, and type-safe API bridges.
Generate and run unit, widget, golden, and integration tests.
Diagnose Flutter errors and audit code quality, security, accessibility, and performance.
Configure native platform permissions, deep links, localization, observability, and on-device AI modules.
Generate CI/CD pipelines, Fastlane, APK/MSIX signing, and web deployment workflows.
Accelerate hackathon prototyping with mock data factories, auth/onboarding flows, charts, and offline demo resilience.
Generates Android manifest configurations (permissions) and multi-platform GitHub Actions workflows for Android AppBundle builds.
Diagnoses CocoaPods build errors in Flutter projects as part of the Compiler Doctor tool.
Ensures Dart 3.6+ compatibility for Flutter app scaffolding and generates pubspec.yaml dependencies.
Provides tools for building production-ready Flutter apps across Mobile, Web (WASM), and Desktop with Clean Architecture, Riverpod/Bloc, and specialized agents for UI, backend, testing, CI/CD, and more.
Generates multi-platform GitHub Actions workflows for Android AppBundle, iOS IPA, and Web WASM builds.
Diagnoses Gradle namespace mismatches and build conflicts in Flutter projects.
Scaffolds Hive caching for backend remote data sources, complementing Drift and Dio REST.
Generates iOS Info.plist permission strings and multi-platform GitHub Actions workflows for iOS IPA builds.
Targets Linux as one of the desktop platforms for Flutter app development.
Targets macOS as one of the desktop platforms for Flutter app development.
Scaffolds Supabase remote data sources as part of the backend specialization, along with Dio REST, Drift/Hive caching, and Riverpod providers.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@flutter-orchestrator Build a Flutter app for iOS and Android with a login flow and backend API"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Flutter Multi-Agent Orchestrator (MCP Server & Skill)
Enterprise-grade Multi-Agent System & Model Context Protocol (MCP) Server for building production-ready Flutter & Dart apps across Mobile (iOS/Android), Web (WASM), and Desktop (macOS/Windows/Linux) with Clean Architecture, Riverpod/Bloc, Dynamic Design/Architecture Document Blueprints, and Hackathon Fast Prototyping.
π― Target Platform Pre-Check Rule
Before starting execution, if target platforms are not specified in the prompt or arguments, the Prompt Architect Agent pauses and requests platform clarification:
π― Target Platforms Required:
Which platform(s) are you targeting for this Flutter app?
1. π± Mobile: iOS & Android (Default)
2. π Web (Responsive WASM / HTML)
3. π» Desktop: macOS, Windows, Linux
4. π All Platforms (Mobile, Web, Desktop)Related MCP server: MCP Mobile Server
π Complete Specialized Agent Roster (24 Tools)
π Project Specifications, Blueprints & Documentation Agents
Specialized Agent | MCP Tool Name | Description & Key Responsibilities | How to Call |
π Blueprint & Spec Architect |
| Generates dynamic, prompt-tailored |
|
π Core Architecture & Engineering Agents
Specialized Agent | MCP Tool Name | Description & Key Responsibilities | How to Call |
π§© Prompt Architect |
| Validates target platforms (asks if missing), breaks down prompts into Clean Architecture features (P0/P1/P2), and builds sprint plans. |
|
π Dependency Researcher |
| Queries pub.dev, ensures Dart 3.6+ / Flutter 3.27+ compatibility, and generates |
|
π¨ UI / UX Specialist |
| Generates responsive Material 3 |
|
βοΈ Backend Specialist |
| Scaffolds Clean Architecture repositories, Dio REST / Supabase remote data sources, Drift/Hive caching, and Riverpod providers. |
|
π©Ί Compiler Doctor |
| Diagnoses RenderFlex overflows, setState during build, pubspec solving conflicts, CocoaPods build errors, and Gradle namespace mismatches. |
|
π§ͺ QA & Test Specialist |
| Generates Unit tests with mocktail, Widget tests with |
|
π Code Quality Auditor |
| Audits Flutter code for unclosed controllers, async calls in |
|
π Cross-Bridge Specialist |
| Generates type-safe Dio REST clients, matching Dart DTO models, Riverpod providers, and WebSocket realtime streams. |
|
π± Native Platform Specialist |
| Generates iOS |
|
π CI/CD & DevOps Engineer |
| Generates multi-platform GitHub Actions workflows with Split-per-ABI signed APKs, automated |
|
πΈ Visual Golden Specialist |
| Generates multi-device golden snapshot test suites across phone and tablet viewports in Light & Dark modes. |
|
π€ On-Device AI Specialist |
| Scaffolds Google Generative AI (Gemini) SDK streaming integration, Riverpod controllers, and interactive chat views. |
|
π Security & Crypto Auditor |
| Audits Flutter code for secret leaks, scaffolds hardware-backed Keychain/Keystore |
|
πΎ Database Architect |
| Scaffolds type-safe Drift (SQLite) database schemas, reactive DAOs, and schema version migration routines. |
|
π Localization (i18n) Specialist |
| Generates |
|
π Observability & Analytics Specialist |
| Scaffolds Sentry/Firebase Crashlytics crash reporting, type-safe custom analytics event taxonomy, and HTTP latency interceptors. |
|
π Deep Linking & Push Specialist |
| Configures |
|
βΏ Accessibility (a11y) Auditor |
| Audits Flutter widgets for WCAG 2.1 AA compliance, screen reader Semantics, minimum 48x48dp touch targets, and scaffolds |
|
π Master Orchestrator |
| Coordinates the entire multi-agent pipeline from platform verification to working project structure. |
|
β‘ Hackathon Fast-Prototyping Agents
Specialized Agent | MCP Tool Name | Description & Key Responsibilities | How to Call |
π Demo Data & Mock Factory |
| Generates deterministic domain mock data factories, fake entities, and in-memory simulated Riverpod repositories for instant UI prototyping. |
|
π Auth & Onboarding Specialist |
| Scaffolds an animated Onboarding carousel (PageView with dots), Material 3 Social login UI (Google/Apple/Email), and token-persisting Riverpod Auth controllers. |
|
π Charts & Data Storytelling |
| Scaffolds interactive animated Line charts, Bar graphs, and Donut charts via |
|
π‘οΈ Hackathon Demo Resilience |
| Guarantees zero crashes during live stage pitches by wrapping network repositories in an automatic fallback interceptor that catches Wi-Fi drops and seamlessly serves cached mock data. |
|
π¦ Installation & Setup
git clone https://github.com/peter14l/flutter-agent-orchestrator.git
cd flutter-agent-orchestrator
npm install
npm run build
npm testAvailable Tools
23 toolsaudit_flutter_accessibilityA
Audits Flutter widget trees against WCAG 2.1 AA guidelines, checks screen reader Semantics, minimum 48x48dp touch targets, and generates AccessibleTouchTarget wrappers.
Inputs: codeSnippet (required).
audit_flutter_codebaseB
Audits Flutter and Dart source code for performance bottlenecks, missing const constructors, controller memory leaks, and architectural violations.
Inputs: code (required), fileType.
audit_flutter_securityC
Audits Flutter source code for hardcoded secrets, unencrypted SharedPreferences, and insecure HTTP endpoints. Scaffolds hardware-backed Keychain/Keystore SecureStorage, Biometric Auth, and SSL Pinning.
Inputs: codeSnippet, enableBiometrics, enableCertificatePinning.
configure_flutter_deep_linksA
Configures go_router deep linking, Android App Links (assetlinks.json), iOS Universal Links (apple-app-site-association), and FCM push notification routing.
Inputs: domainHost (required), customScheme (required), routes.
decompose_flutter_promptA
Deconstructs Flutter prompts into Clean Architecture features, modules, and sprint plans. Always checks and verifies target platforms (iOS, Android, Web, Desktop) first.
Inputs: prompt (required), projectName, stateManagement, targetPlatforms, +1 more.
design_flutter_uiA
Designs production-ready Flutter widgets, Material 3 responsive layouts (Mobile/Web/Desktop), Riverpod/Bloc state integration, and fluid animations.
Inputs: screenName (required), layoutDescription (required), stateManagement, targetPlatforms.
diagnose_flutter_errorsB
Diagnoses Flutter errors including RenderFlex overflows, setState during build, pubspec version conflicts, CocoaPods build errors, and Gradle namespace mismatches.
Inputs: errorMessage (required), stackTrace, codeSnippet, flutterDoctorOutput.
generate_and_run_flutter_testsC
Generates Flutter Unit tests, Widget tests with testWidgets, and Riverpod/Bloc state tests, along with test execution commands.
Inputs: className (required), testType, stateManagement, methodsOrWidgetsToTest.
generate_flutter_api_bridgeA
Generates full-stack Flutter API client contracts: Dio REST client, JSON DTOs, Riverpod providers, and WebSocket realtime subscription providers.
Inputs: serviceName (required), models, baseUrl, endpoints.
generate_flutter_chartsB
Scaffolds animated interactive Line charts, Bar graphs, and Donut charts via fl_chart with gradient fills and tooltips for hackathon data storytelling.
Inputs: chartTitle (required), chartType, dataPoints.
generate_flutter_cicd_pipelineA
Generates production multi-platform GitHub Actions workflows for Flutter with Split-per-ABI signed APKs, automated 'gh secret set' keystore script, Windows MSIX packaging with self-signed test certificates, and Fastlane.
Inputs: projectName (required), enableFastlane, enableWebDeploy, targetPlatforms, +2 more.
generate_flutter_golden_testsB
Generates multi-device golden snapshot test suites for Flutter widgets across Light/Dark modes, phone, and tablet viewports.
Inputs: screenName (required), testThemes, widgetName.
generate_flutter_localizationA
Generates l10n.yaml, standard ARB localization translation files (en, es, ar), dynamic locale switching notifier, and Right-to-Left (RTL) language handling.
Inputs: stringKeys, defaultLocale, supportedLocales.
generate_flutter_mock_factoryA
Generates realistic domain mock data factories, fake entities, and in-memory mock repositories for instant hackathon UI prototyping.
Inputs: domainName (required), fields, itemCount.
generate_flutter_platform_configB
Generates native platform configurations: iOS Info.plist permission strings, AndroidManifest.xml permissions, and Web WASM CanvasKit bootstrap.
Inputs: projectName (required), permissions, targetPlatforms.
orchestrate_flutter_projectA
End-to-end multi-agent orchestration for Flutter apps. Checks target platforms first (asks if not specified), then executes prompt decomposition, pubspec creation, UI screens, backend/state layer, and tests.
Inputs: prompt (required), includeUi, projectName, includeTests, +3 more.
research_flutter_dependenciesA
Researches pub.dev packages, verifies Dart 3.6+ / Flutter 3.27+ compatibility, and generates a standard pubspec.yaml and analysis_options.yaml.
Inputs: packages, projectName, stateManagement, targetPlatforms.
scaffold_flutter_ai_moduleB
Scaffolds Google Generative AI (Gemini) SDK integration for Flutter with streaming responses, Riverpod state controllers, and interactive chat views.
Inputs: featureName (required), provider, systemInstruction.
scaffold_flutter_auth_flowA
Scaffolds an instant animated Onboarding carousel (PageView with dots), Material 3 Social login UI (Google/Apple/Email), and token-persisting Riverpod Auth controllers.
Inputs: appName (required), enableSocialLogins, enableOnboardingCarousel.
scaffold_flutter_backendB
Scaffolds Clean Architecture repositories, Dio/Supabase remote data sources, Drift/Hive local caching, and Riverpod/Bloc business controllers.
Inputs: featureName (required), database, backendProvider, stateManagement.
scaffold_flutter_databaseB
Scaffolds an offline-first type-safe Drift (SQLite) database with table schemas, DAOs with reactive streams, and schema version migration routines.
Inputs: databaseName (required), tables, schemaVersion.
scaffold_flutter_observabilityC
Scaffolds Sentry/Firebase Crashlytics crash reporting, type-safe custom analytics event loggers, and HTTP request latency interceptors.
Inputs: provider, customEventNames, enablePerformanceMonitoring.
scaffold_flutter_offline_resilienceC
Scaffolds an automatic fallback interceptor that catches Wi-Fi drops / network failures and seamlessly serves cached/embedded mock data with zero crash during live stage demos.
Inputs: cacheDurationMinutes, enableDemoMockFallback.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 23 tools
Most tools target distinct lifecycle phases (UI design, backend scaffolding, testing, security, observability), but generate_flutter_mock_factory and generate_flutter_charts are both for UI data presentation, and the three scaffold_* tools could be confused by name.
Tool names predominantly follow a verb_noun snake_case pattern (generate_, scaffold_, audit_, configure_, design_, diagnose_). A few deviations like orchestrate_flutter_project and generate_and_run_flutter_tests do not break the overall consistency.
23 tools for an end-to-end Flutter generator server is justified given the coverage of UI, backend, tests, platforms, CI/CD, security, localization, auth, mocks, and observability. Count is on the higher side but well-scoped for full-stack generation.
Coverage spans prompt decomposition, UI, backend, database, tests, platform configs, CI/CD, localization, deep links, mocks, auth, observability, and offline fallback. Minor exceptions like a dedicated code-gen migration tool or app store screenshots could be considered, but nonessential.
Related MCP Connectors
Build, validate, and deploy multi-agent AI solutions from any AI environment.
Create and manage AI agents that collaborate and solve problems through natural language interactiβ¦
Build and host full-stack apps from a prompt, with agents that reach you on WhatsApp and email.
Generate a Flutter app from a JSON spec free; pay only for the compiled APK (USDC on Base).
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI coding agents to extract Figma design data and convert it into Flutter widgets and screens. Supports theme setup, component analysis, asset exports, and provides Flutter implementation guidance from Figma designs.62 npm242MIT
- AlicenseBqualityDmaintenanceTransforms AI assistants into mobile development powerhouses with 36 tools for Flutter, Android, and iOS development, including intelligent device management, automated builds, testing, and deployment workflows.3115 npm8MIT
- AlicenseNot gradedqualityDmaintenanceCoordinates specialized agents (Architecture, Quality, Cloud, Prompt) to plan, build, test, and deploy applications with self-healing capabilities, authentication, and analytics for autonomous software engineering workflows.1MIT
- FlicenseNot gradedqualityCmaintenanceEnable AI agents to autonomously build and deploy full-stack mobile applications.1-