Skip to main content
Glama
flutter-orchestrator

flutter-orchestrator

by peter14l

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

scaffold_flutter_project_docs

Generates dynamic, prompt-tailored PRD.md, architecture.md, rules.md, phases.md, design.md, and memory.md. Checks if files already exist before writing to prevent overwriting manual notes.

scaffold_flutter_project_docs({ projectName: "MyApp", appDescription: "..." })

πŸš€ Core Architecture & Engineering Agents

Specialized Agent

MCP Tool Name

Description & Key Responsibilities

How to Call

🧩 Prompt Architect

decompose_flutter_prompt

Validates target platforms (asks if missing), breaks down prompts into Clean Architecture features (P0/P1/P2), and builds sprint plans.

decompose_flutter_prompt({ prompt: "...", targetPlatforms: ["ios", "android"] })

🌐 Dependency Researcher

research_flutter_dependencies

Queries pub.dev, ensures Dart 3.6+ / Flutter 3.27+ compatibility, and generates pubspec.yaml & analysis_options.yaml.

research_flutter_dependencies({ projectName: "my_app", stateManagement: "riverpod" })

🎨 UI / UX Specialist

design_flutter_ui

Generates responsive Material 3 ConsumerWidget screens with domain archetype detection (Fintech, E-Commerce, Fitness, AI, Dashboards), 8-pt spatial grid, and fluid micro-animations.

design_flutter_ui({ screenName: "DashboardScreen", layoutDescription: "..." })

βš™οΈ Backend Specialist

scaffold_flutter_backend

Scaffolds Clean Architecture repositories, Dio REST / Supabase remote data sources, Drift/Hive caching, and Riverpod providers.

scaffold_flutter_backend({ featureName: "Order", backendProvider: "rest-dio" })

🩺 Compiler Doctor

diagnose_flutter_errors

Diagnoses RenderFlex overflows, setState during build, pubspec solving conflicts, CocoaPods build errors, and Gradle namespace mismatches.

diagnose_flutter_errors({ errorMessage: "RenderFlex overflowed by 48px..." })

πŸ§ͺ QA & Test Specialist

generate_and_run_flutter_tests

Generates Unit tests with mocktail, Widget tests with testWidgets, and ProviderContainer tests.

generate_and_run_flutter_tests({ className: "OrderScreen", testType: "widget" })

πŸ” Code Quality Auditor

audit_flutter_codebase

Audits Flutter code for unclosed controllers, async calls in build(), and performance anti-patterns.

audit_flutter_codebase({ code: "...", fileType: "widget" })

🌐 Cross-Bridge Specialist

generate_flutter_api_bridge

Generates type-safe Dio REST clients, matching Dart DTO models, Riverpod providers, and WebSocket realtime streams.

generate_flutter_api_bridge({ serviceName: "Order", endpoints: [...] })

πŸ“± Native Platform Specialist

generate_flutter_platform_config

Generates iOS Info.plist permission strings, Android AndroidManifest.xml permissions, and Web WASM bootstrap.

generate_flutter_platform_config({ projectName: "MyApp", permissions: ["camera", "location"] })

πŸš€ CI/CD & DevOps Engineer

generate_flutter_cicd_pipeline

Generates multi-platform GitHub Actions workflows with Split-per-ABI signed APKs, automated gh secret set keystore setup, Windows MSIX test-cert signing, and Fastlane.

generate_flutter_cicd_pipeline({ projectName: "MyApp", enableSplitPerAbiApk: true })

πŸ“Έ Visual Golden Specialist

generate_flutter_golden_tests

Generates multi-device golden snapshot test suites across phone and tablet viewports in Light & Dark modes.

generate_flutter_golden_tests({ screenName: "DashboardScreen" })

πŸ€– On-Device AI Specialist

scaffold_flutter_ai_module

Scaffolds Google Generative AI (Gemini) SDK streaming integration, Riverpod controllers, and interactive chat views.

scaffold_flutter_ai_module({ featureName: "ChatAssistant", provider: "google-generative-ai" })

πŸ” Security & Crypto Auditor

audit_flutter_security

Audits Flutter code for secret leaks, scaffolds hardware-backed Keychain/Keystore FlutterSecureStorage, Biometric Auth, and SSL Pinning.

audit_flutter_security({ codeSnippet: "...", enableBiometrics: true })

πŸ’Ύ Database Architect

scaffold_flutter_database

Scaffolds type-safe Drift (SQLite) database schemas, reactive DAOs, and schema version migration routines.

scaffold_flutter_database({ databaseName: "Expense", tables: [...] })

🌍 Localization (i18n) Specialist

generate_flutter_localization

Generates l10n.yaml, ARB localization files (en, es, ar), dynamic locale switcher, and Right-to-Left (RTL) language handling.

generate_flutter_localization({ supportedLocales: ["en", "es", "ar"], stringKeys: {...} })

πŸ“Š Observability & Analytics Specialist

scaffold_flutter_observability

Scaffolds Sentry/Firebase Crashlytics crash reporting, type-safe custom analytics event taxonomy, and HTTP latency interceptors.

scaffold_flutter_observability({ provider: "sentry", customEventNames: ["checkout_done"] })

πŸ”— Deep Linking & Push Specialist

configure_flutter_deep_links

Configures go_router deep links, Android App Links (assetlinks.json), iOS Universal Links (apple-app-site-association), and FCM notification routing.

configure_flutter_deep_links({ customScheme: "myapp", domainHost: "app.example.com", routes: [...] })

β™Ώ Accessibility (a11y) Auditor

audit_flutter_accessibility

Audits Flutter widgets for WCAG 2.1 AA compliance, screen reader Semantics, minimum 48x48dp touch targets, and scaffolds AccessibleTouchTarget.

audit_flutter_accessibility({ codeSnippet: "IconButton(icon: Icon(Icons.add), ...)" })

πŸš€ Master Orchestrator

orchestrate_flutter_project

Coordinates the entire multi-agent pipeline from platform verification to working project structure.

orchestrate_flutter_project({ prompt: "...", targetPlatforms: ["android", "ios"] })

⚑ Hackathon Fast-Prototyping Agents

Specialized Agent

MCP Tool Name

Description & Key Responsibilities

How to Call

🎭 Demo Data & Mock Factory

generate_flutter_mock_factory

Generates deterministic domain mock data factories, fake entities, and in-memory simulated Riverpod repositories for instant UI prototyping.

generate_flutter_mock_factory({ domainName: "Product", itemCount: 10 })

πŸ” Auth & Onboarding Specialist

scaffold_flutter_auth_flow

Scaffolds an animated Onboarding carousel (PageView with dots), Material 3 Social login UI (Google/Apple/Email), and token-persisting Riverpod Auth controllers.

scaffold_flutter_auth_flow({ appName: "HackathonApp" })

πŸ“ˆ Charts & Data Storytelling

generate_flutter_charts

Scaffolds interactive animated Line charts, Bar graphs, and Donut charts via fl_chart with gradient fills and tooltips.

generate_flutter_charts({ chartTitle: "Revenue Trends", chartType: "line" })

πŸ›‘οΈ Hackathon Demo Resilience

scaffold_flutter_offline_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.

scaffold_flutter_offline_resilience({ enableDemoMockFallback: true })


πŸ“¦ Installation & Setup

git clone https://github.com/peter14l/flutter-agent-orchestrator.git
cd flutter-agent-orchestrator
npm install
npm run build
npm test

Available Tools

23 tools
audit_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.

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

    B3.4/5.0

    Scored across 23 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers