Kotlin Multi-Agent Orchestrator (MCP Server & Skill)

Enterprise-grade Multi-Agent System & Model Context Protocol (MCP) Server for building production-ready Kotlin apps across Android (Jetpack Compose), Compose Multiplatform (CMP), Ktor Backend, and Spring Boot.

🌟 Key Capabilities & Specialized Agent Team

⚡ Performance & Design

• Zero-Latency Execution: Built with optimized TypeScript, in-memory caching, and sub-10ms response times.

• Progressive Disclosure: Built-in support for Antigravity progressive loading to keep context windows clean.

• Kotlin 2.x & K2 Ready: Out-of-the-box compatibility with the new official JetBrains Kotlin Compose Compiler plugin and modern Android Gradle Plugin standards.

📦 Installation & Setup

1. Build the MCP Server

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

2. Antigravity CLI Integration

Add the server to your Antigravity configuration (mcp_config.json or .agents/mcp.json):

{
  "mcpServers": {
    "kotlin-orchestrator": {
      "command": "node",
      "args": ["C:/Users/LOQ/kotlin-agent-orchestrator/dist/index.js"]
    }
  }
}

Or copy the skill to your project's .agents/skills/ directory:

mkdir -p .agents/skills/kotlin-orchestrator
cp SKILL.md .agents/skills/kotlin-orchestrator/

3. OpenCode Integration

Add this entry to your OpenCode configuration (~/.config/opencode/config.json or project opencode.json):

{
  "mcp": {
    "servers": {
      "kotlin-orchestrator": {
        "command": "node",
        "args": ["C:/Users/LOQ/kotlin-agent-orchestrator/dist/index.js"],
        "enabled": true
      }
    }
  }
}

🛠️ MCP Tools Overview

1. orchestrate_kotlin_project

Runs the complete multi-agent pipeline from raw prompt to working project structure.

{
  "prompt": "Build a real-time crypto portfolio tracker with offline caching and Material 3 UI",
  "projectName": "CryptoPortfolio",
  "targetPlatform": "android-compose",
  "includeUi": true,
  "includeBackend": true,
  "includeTests": true
}

2. decompose_kotlin_prompt

Deconstructs large or vague requirements into technical specifications.

{
  "prompt": "Build an e-commerce checkout flow with cart, discount coupons, and Stripe payment",
  "projectName": "ShopCheckout",
  "targetPlatform": "android-compose"
}

3. research_kotlin_dependencies

Generates standard Gradle Version Catalogs (libs.versions.toml).

{
  "targetPlatform": "android-compose",
  "libraries": ["coil", "room", "koin", "ktor"]
}

4. design_kotlin_ui

Generates Jetpack Compose / CMP Composable screens, ViewModels, and Previews.

{
  "screenName": "CartScreen",
  "targetPlatform": "android-compose",
  "layoutDescription": "Cart items list with quantity controls, promo code field, and total price checkout bar."
}

5. scaffold_kotlin_backend

Scaffolds Ktor or Spring Boot Kotlin services with repositories and DI.

{
  "domainName": "Order",
  "backendType": "ktor",
  "database": "exposed"
}

6. diagnose_kotlin_errors

Diagnoses compilation errors, Gradle issues, and runtime crashes.

{
  "errorMessage": "This version (1.5.14) of the Compose Compiler requires Kotlin version 1.9.24 but you appear to be using Kotlin version 2.1.0"
}

7. generate_and_run_tests

Generates Unit, Turbine Flow, and Compose UI tests.

{
  "className": "CartViewModel",
  "testType": "viewmodel",
  "methodsToTest": ["applyCoupon", "checkout"]
}

8. audit_kotlin_codebase

Reviews Kotlin code for performance, threading, and coroutine anti-patterns.

{
  "code": "fun load() { GlobalScope.launch { Thread.sleep(1000) } }",
  "fileType": "viewmodel"
}

🧪 Running Tests

npm test

All unit and integration tests execute using Node's native test runner in ~100ms.