# Agent-MCP Capability Matrix

This document maps each agent to its required MCP servers and skills.

## Agents by Category

### Core Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **architect** | documentation, api-explorer, skill-loader | clean-code, solid-principles, token-optimization (core); on demand: web/enterprise (DDD, event-sourcing/CQRS, multitenancy, Spring Cloud, API design), `systems/*` (OS-kernel, embedded-RTOS, systems-networking, storage-engines, distributed-consensus, virtualization, hardware-aware, data-intensive, security-architecture, distributed-ledger, cyber-physical, game-engine), `ai-systems/*` (edge-inference, inference-serving-topology, hybrid-edge-cloud, ai-hardware-selection, model-gateway-routing, agentic-architecture) |
| **code-reviewer** | documentation, code-quality | clean-code, solid-principles, git-workflow |
| **typescript-expert** | documentation | typescript, advanced-types |
| **nodejs-expert** | documentation | nodejs, npm, async-patterns |
| **python-expert** | documentation | python, pip, async-python |
| **documentation-expert** | documentation | tsdoc, jsdoc, api-docs |
| **accessibility-expert** | documentation | wcag, aria, a11y-testing |
| **log-analyst** | log-analyzer | logging, debugging, observability |
| **performance-expert** | performance-profiler | profiling, optimization, benchmarking |
| **dashboard-refactor-expert** | documentation | react, typescript, refactoring |
| **claude-code-extension-expert** | _(none)_ | skill-authoring, agent-authoring, hook-authoring, mcp-authoring, plugin-authoring |

### Backend Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **spring-boot-expert** | documentation, api-tester | spring-boot, spring-data-jpa, spring-security, spring-web, flyway, lombok, mapstruct |
| **nestjs-expert** | documentation, api-tester | nestjs, typescript, prisma, postgresql |
| **fastapi-expert** | documentation, api-tester | fastapi, python, sqlalchemy, pydantic, pytest |
| **rust-expert** | documentation | rust, actix-web, axum, rocket, warp, proptest, rustls, arti, rusqlite, rust-decimal, rust-supply-chain, osv-scanner, rust-tracing, rust-cross-compile |
| **go-expert** | documentation | go, gin, fiber, echo, chi |
| **deno-expert** | documentation | deno, fresh, oak, typescript |
| **dotnet-expert** | documentation, api-tester | aspnet-core, aspnet-minimal-api, aspnet-middleware, aspnet-signalr, aspnet-blazor, aspnet-identity, aspnet-validation, entity-framework-core, csharp, xunit, nunit, dotnet-quality, dotnet-security, postgresql, sql-server, swagger-dotnet, resilience-patterns, caching-strategies, webhooks, pagination, error-handling, cors-security-headers, error-tracking, health-checks, ddd |
| **streamlit-expert** | documentation | streamlit, python, pandas, pydantic, pytest, ruff |
| **cpp-expert** | documentation, code-quality | cpp, cmake, googletest, cpp-quality, cpp-security |
| **windows-driver-expert** | documentation | cpp, cmake, cpp-quality, cpp-security, wdf-kmdf, wdf-umdf, hid-input-filter, indirect-display, driver-debugging, driver-signing |

### Frontend Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **react-expert** | documentation, code-quality | react, react-hooks, typescript, tailwindcss, shadcn-ui, zustand, tanstack-query |
| **nextjs-expert** | documentation | nextjs, react, typescript, server-components, app-router |
| **vue-expert** | documentation | vue, nuxt, typescript, pinia, tailwindcss |
| **svelte-expert** | documentation | svelte, sveltekit, typescript, tailwindcss |
| **electron-expert** | documentation | electron, react, typescript, nodejs, ipc |
| **tauri-expert** | documentation | tauri, rust, typescript, svelte, vite |
| **angular-expert** | documentation | angular, angular-routing, angular-forms, angular-http, angular-testing, angular-material, angular-ssr, typescript, ngrx, vitest, i18n |
| **ux-expert** | documentation | ux-design, visual-hierarchy, design-tokens, interaction-design, motion-design, mobile-ux, color-systems, ethical-design |
| **creative-frontend-expert** | documentation | animation/framer-motion, animation/gsap, graphics/three-js, graphics/svg-animation, graphics/canvas-webgl, styling/advanced-css-effects |

### Database Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **prisma-expert** | documentation | prisma, postgresql, mysql, typescript |
| **sql-expert** | documentation, database-query | postgresql, mysql, sql-optimization |
| **mongodb-expert** | documentation | mongodb, aggregations, spring-data-mongodb |

### Testing Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **vitest-expert** | documentation, code-quality | vitest, testing-library, mocking, coverage |
| **playwright-expert** | documentation | playwright, e2e-testing, page-objects |
| **spring-boot-integration-test-expert** | documentation | spring-boot-test, testcontainers, junit |
| **python-integration-test-expert** | documentation | python-integration, testcontainers-python, pytest-django, fastapi-testing, factory-boy |
| **smoke-test-expert** | api-tester, database-query, docker-manager, log-analyzer, documentation | smoke-test, rest-assured, testcontainers |

### Infrastructure Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **docker-expert** | docker-manager | docker, docker-compose, kubernetes |
| **devops-expert** | docker-manager | github-actions, ci-cd, deployment |

### Quality Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **qa-expert** | documentation, code-quality | testing-strategies, quality-assurance |
| **integration-validator-expert** | documentation, api-explorer | api-contracts, openapi, frontend-backend-sync |
| **open-source-expert** | documentation, code-quality | open-source, git-workflow, clean-code, supply-chain, secrets-management, license-compliance |

### Security Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **security-expert** | security-scanner, documentation | owasp, jwt, oauth2, secrets-management |

### Messaging Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **messaging-expert** | documentation | kafka, rabbitmq, event-driven-architecture, spring-kafka, spring-amqp |

### Cloud Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **cloud-expert** | documentation | aws, azure, gcp, serverless, cloud-storage, terraform, caching-strategies, resilience-patterns, feature-flags, multitenancy, secrets-management, iac-security, deployment-strategies, health-checks, api-gateway, service-mesh |

### Mobile Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **mobile-expert** | documentation | react-native, flutter, expo, push-notifications, i18n, webauthn, stripe, file-upload |
| **kmp-expert** | documentation | languages/kotlin, languages/swift, languages/uniffi, languages/java-foreign, mobile/kotlin-multiplatform, frontend-frameworks/compose-multiplatform, build-tools/gradle-kmp, build-tools/rust-cross-compile, testing/kotest, testing/turbine, testing/maestro, testing/compose-snapshot, testing/proptest, observability/rust-tracing, observability/sentry-selfhosted, infrastructure/reproducible-builds, security/sigstore-cosign, quality/rust-supply-chain, quality/kotlin-quality, quality/osv-scanner, documentation/docs-toolchain |
| **android-native-expert** | documentation | languages/kotlin, mobile/jetpack-compose, mobile/android-native, databases/sqlcipher, security/libsodium, security/age-encryption, testing/kotest, testing/turbine, testing/maestro, testing/compose-snapshot, security/sigstore-cosign, quality/kotlin-quality, quality/osv-scanner, observability/sentry-selfhosted |
| **ios-native-expert** | documentation | languages/swift, mobile/ios-native, databases/sqlcipher, security/libsodium, security/age-encryption, testing/maestro, security/sigstore-cosign, quality/osv-scanner, observability/sentry-selfhosted |

### Game Development Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **unity-expert** | documentation | csharp, unity-core, unity-rendering, unity-input-ui, unity-physics-anim, unity-addressables, unity-performance, unity-dots, unity-netcode, unity-xr, unity-editor-tooling, unity-testing, unity-build-platforms, unity-best-practices, unity-2d-core, unity-2d-tilemap, unity-2d-physics, unity-2d-animation, unity-2d-lighting, unity-2d-cameras, unity-2d-gameplay |

> Optional external MCPs (not bundled): `CoplayDev/unity-mcp` (MIT) or `IvanMurzak/Unity-MCP` (Apache-2.0) for direct Unity Editor control (scenes, scripts, assets, profiler, builds). Install separately.

### Data Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **data-engineering-expert** | documentation | pandas, pydantic, python, pytest, ruff |
| **rag-expert** | documentation | rag (architecture, chunking, retrieval, evaluation, agentic, graph, multimodal, guardrails, caching, security, observability, production), retrieval (ColBERT, SPLADE, BM25, RankGPT, cross-encoder), embeddings, vector-stores, document-processing, rag-frameworks (LlamaIndex, Haystack, DSPy, LangGraph, +4), rag-ops (TEI, batch, cost, multi-region, gateway) |

### Industrial Agents

| Agent | MCP Servers | Skills |
|-------|-------------|--------|
| **dcs-analyst** | documentation | industrial/freelance-formats, industrial/isa-standards, industrial/dcs-platforms |
| **freelance-engineer** | documentation | industrial/freelance-formats, industrial/isa-standards, industrial/bulk-engineering |
| **automation-architect** | documentation | industrial/freelance-formats, industrial/isa-standards, industrial/dcs-platforms, industrial/iec61131, industrial/bulk-engineering, pandas, pydantic |
| **membrane-expert** | documentation | industrial/membrane-ro-fundamentals, industrial/membrane-troubleshooting, industrial/membrane-economics-edi, industrial/membrane-pretreatment, industrial/membrane-nf, industrial/membrane-autopsy |

## MCP Server Requirements

| MCP Server | Used By Agents |
|------------|----------------|
| **documentation** | All agents |
| **database-query** | sql-expert, smoke-test-expert |
| **docker-manager** | docker-expert, devops-expert, smoke-test-expert |
| **code-quality** | code-reviewer, react-expert, vitest-expert, qa-expert, open-source-expert |
| **log-analyzer** | log-analyst, smoke-test-expert |
| **performance-profiler** | performance-expert |
| **security-scanner** | security-expert |
| **api-explorer** | integration-validator-expert |
| **api-tester** | spring-boot-expert, nestjs-expert, fastapi-expert, dotnet-expert, smoke-test-expert |
| **dashboard-bridge** | (optional, for orchestrator integration) |

## Recommended Configurations

### Fullstack TypeScript (Next.js + NestJS)
```json
{
  "agents": ["nextjs-expert", "nestjs-expert", "prisma-expert", "vitest-expert", "playwright-expert", "docker-expert"],
  "mcpServers": ["documentation", "database-query", "docker-manager", "code-quality"]
}
```

### Spring Boot + React
```json
{
  "agents": ["spring-boot-expert", "react-expert", "sql-expert", "docker-expert", "vitest-expert"],
  "mcpServers": ["documentation", "database-query", "docker-manager", "code-quality"]
}
```

### Python FastAPI
```json
{
  "agents": ["fastapi-expert", "python-expert", "sql-expert", "docker-expert"],
  "mcpServers": ["documentation", "database-query", "docker-manager", "api-tester"]
}
```

### Rust Backend
```json
{
  "agents": ["rust-expert", "sql-expert", "docker-expert"],
  "mcpServers": ["documentation", "database-query", "docker-manager"]
}
```

### Go Backend
```json
{
  "agents": ["go-expert", "sql-expert", "docker-expert"],
  "mcpServers": ["documentation", "database-query", "docker-manager"]
}
```

### Python Streamlit + Data Engineering
```json
{
  "agents": ["streamlit-expert", "data-engineering-expert", "python-expert", "qa-expert"],
  "mcpServers": ["documentation", "database-query"]
}
```

### Industrial DCS / PLC Automation (ABB Freelance)
```json
{
  "agents": ["dcs-analyst", "freelance-engineer", "automation-architect", "data-engineering-expert", "python-expert"],
  "mcpServers": ["documentation"]
}
```

### Creative Frontend (Landing Pages, 3D, Animation)
```json
{
  "agents": ["creative-frontend-expert", "ux-expert", "react-expert"],
  "mcpServers": ["documentation"]
}
```
