frontier-orchestrator
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., "@frontier-orchestratorDelegate creating the user registration API to Codex."
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.
Frontier Orchestrator — Multi-Agent Orchestration for Claude Code
Frontier Orchestrator is a Model Context Protocol (MCP) server and Claude Code skill that turns Claude into the lead engineer of a multi-agent team. Claude decomposes tasks, defines cross-stack contracts, and verifies results — while delegating:
Backend work (APIs, databases, migrations, auth, infrastructure, security, backend tests) to OpenAI Codex
Frontend and design work (UI, UX, components, styling, accessibility, animation, client state) to Kimi Code
Tooling and mechanical maintenance (build configuration, dependency upgrades, CI, release automation, generated boilerplate, repository transformations, test/lint cleanup) to Grok Build
Each specialist runs as a sandboxed subprocess in your repository, receives a role-scoped brief with explicit file ownership and acceptance criteria, and reports back in a structured format that Claude reviews before anything reaches you.
Why multi-agent orchestration?
Frontier coding agents have different strengths. Instead of asking one model to do everything, Frontier Orchestrator routes each part of a full-stack task to the agent best suited for it — with enforced coordination discipline so agents never trample each other's changes:
Domain-first routing — backend behavior goes to Codex, frontend and UX behavior goes to Kimi, and only domain-neutral tooling or mechanical maintenance goes to Grok unless you explicitly override routing. Grok is never selected solely because it is faster.
Workspace mutation guard — two specialists cannot edit overlapping directories at the same time unless Claude explicitly certifies their file scopes are disjoint.
Contract-first sequencing — for an unknown cross-stack interface, Codex analyzes the backend contract first; Kimi builds against the accepted contract. A frontend task can never silently invent a backend API.
Read-only modes —
analyzeandreviewdelegations run the specialist CLI in a read-only sandbox; onlyimplementmay edit the workspace.
Related MCP server: Landlord
How it works
flowchart LR
U[You] --> C[Claude Code<br/>lead engineer]
C -->|delegate_backend| M[frontier-orchestrator<br/>MCP server]
C -->|delegate_frontend| M
C -->|delegate_build| M
M -->|codex exec<br/>sandboxed| X[OpenAI Codex<br/>backend specialist]
M -->|kimi --print<br/>sandboxed| K[Kimi Code<br/>frontend specialist]
M -->|grok -p<br/>sandboxed| G[Grok Build<br/>tooling/maintenance specialist]
X --> M
K --> M
G --> M
M -->|structured JSON result| C
C -->|reviewed, integrated,<br/>verified result| UThe MCP server exposes four tools:
Tool | Purpose |
| Check that the Codex, Kimi, and Grok CLIs are installed and report versions |
| Send a bounded backend task to Codex ( |
| Send a bounded design/frontend task to Kimi ( |
| Send domain-neutral tooling or mechanical maintenance to Grok Build ( |
Each delegation takes a structured request — task, mode, context, file_scope, acceptance_criteria, optional model override, and a hard timeout_seconds — and returns JSON with the specialist's final message, exit code, duration, and diagnostics on failure.
The companion orchestrate-specialists skill (in .claude/skills/) teaches Claude the domain-first routing rules, backend-first and frontend-first sequencing patterns, Grok's tooling and maintenance boundary, parallelization preconditions, and guardrails (see routing-contract.md).
Quick start
Requirements: Node.js 20+, Claude Code, and authenticated codex, kimi, and grok CLIs for the specialists you intend to use. A missing optional CLI only makes that specialist unavailable.
git clone https://github.com/luckeyfaraday/frontier-orchestrator.git
cd frontier-orchestrator
npm install
npm run buildLaunch Claude Code from this repository. Claude discovers the project-scoped .mcp.json and the skill automatically. Approve the MCP server when prompted, then run:
/orchestrate-specialistsVerify the connection with /mcp or:
claude mcp get frontier-orchestratorUse from any project
Install the MCP server at user scope:
npm install && npm run build && npm link
claude mcp add --scope user frontier-orchestrator -- frontier-orchestratorCopy the skill to user scope:
mkdir -p ~/.claude/skills
cp -R .claude/skills/orchestrate-specialists ~/.claude/skills/Restart Claude Code after changing MCP configuration.
Example delegation
A typical full-stack feature flows like this:
Claude inspects the repo and writes acceptance criteria plus file scopes for each side.
delegate_backendwithmode: analyze— Codex proposes the API contract.Claude normalizes the contract and passes it to Kimi.
delegate_backendanddelegate_frontendwithmode: implement— run sequentially, or in parallel only when file scopes are disjoint (allow_concurrent_mutation: true). Separate domain-neutral tooling or mechanical maintenance can go todelegate_build; a stable application contract does not transfer backend or frontend ownership to Grok.Claude inspects every changed file, runs the integrated checks, fixes small integration defects, and reports one unified result.
Configuration
The server inherits existing Codex, Kimi, and Grok authentication from their CLIs. All settings are environment variables:
Environment variable | Default | Purpose |
|
| Base workspace for relative paths |
| project root | Additional allowed roots, separated by the platform path delimiter |
|
| Codex executable or absolute path |
|
| Kimi executable or absolute path |
|
| Grok executable or absolute path |
|
| Maximum simultaneous specialist processes |
|
| Per-stream child output retained in memory |
|
| Maximum specialist text returned to Claude |
Implementation calls are serialized per working directory unless Claude explicitly sets allow_concurrent_mutation: true. The skill only permits that when file scopes are disjoint and the cross-stack contract is stable.
FAQ
What is Frontier Orchestrator? A local stdio MCP server plus a Claude Code skill that lets Claude orchestrate OpenAI Codex, Kimi Code, and Grok Build as specialists — Codex for backend engineering, Kimi for design and frontend, and Grok for domain-neutral tooling and mechanical maintenance — while Claude remains responsible for decomposition, contracts, review, and integration.
How is this different from Claude Code subagents? Subagents run more instances of Claude. Frontier Orchestrator routes work to different frontier models by domain and workload strength, wrapped in file-scope and mutation guardrails, with Claude reviewing everything before completion.
Does it need API keys?
No keys of its own. It shells out to the codex, kimi, and grok CLIs and inherits whatever authentication those CLIs already have.
Can specialists run in parallel?
Yes, up to FRONTIER_MAX_CONCURRENCY processes — but workspace mutations are serialized per directory unless Claude explicitly certifies disjoint file scopes.
Is it safe to let specialists edit my repo?
analyze and review modes are read-only. implement uses each provider's workspace-editing mode and instructs every specialist to stay inside its declared file scope; Claude inspects all diffs before presenting completion.
Troubleshooting
LLM not setfrom Kimi means no provider/model is configured. Runkimi login, complete the browser authorization and model selection, then retry.Authentication errors from Grok mean its CLI session is unavailable or expired. Run
grok login, then confirm the account's available models withgrok models.A project-scoped MCP server appears as pending until you open Claude Code in the repository and approve
.mcp.json.specialist_statuschecks executable availability and versions; a real delegation is the definitive authentication/configuration check.
Development
npm run check # typecheck
npm test # build + node --testSource layout: src/index.ts (MCP server and tools), src/specialists.ts (Codex, Kimi, and Grok CLI invocations and specialist prompts), src/coordinator.ts (concurrency gate and workspace mutation guard), src/config.ts (environment configuration and path allow-listing), src/process.ts (subprocess lifecycle).
License
MIT © luckeyfaraday
Available Tools
4 toolsdelegate_backendDelegate backend work to CodexADestructive
Delegate backend, API, database, auth, infrastructure, security, performance, or backend-test work to Codex. Use analyze/review for read-only work and implement for edits.
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Analyze/review are read-only; implement may edit the workspace. | implement |
| task | Yes | Concrete, self-contained specialist task. | |
| model | No | Optional provider-specific model override. | |
| context | No | Relevant architectural context, interfaces, decisions, and constraints. | |
| file_scope | No | Files or directories this specialist owns for this task. | |
| timeout_seconds | No | Hard timeout for the specialist CLI process. | |
| working_directory | No | Directory relative to the Claude project root, or an allowed absolute path. | . |
| acceptance_criteria | No | Observable conditions the specialist should satisfy. | |
| allow_concurrent_mutation | No | Allow simultaneous edits in one workspace only when file scopes are known not to overlap. |
delegate_buildDelegate tooling and maintenance work to Grok BuildADestructive
Delegate domain-neutral build tooling, dependency or toolchain upgrades, CI and release automation, mechanical repository-wide transformations, generated boilerplate, or test and lint cleanup to Grok Build. Backend behavior belongs to Codex and frontend or UX behavior belongs to Kimi unless the user explicitly overrides routing. Never choose Grok solely for speed. Use analyze/review for read-only work and implement for edits.
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Analyze/review are read-only; implement may edit the workspace. | implement |
| task | Yes | Concrete, self-contained specialist task. | |
| model | No | Optional provider-specific model override. | |
| context | No | Relevant architectural context, interfaces, decisions, and constraints. | |
| file_scope | No | Files or directories this specialist owns for this task. | |
| timeout_seconds | No | Hard timeout for the specialist CLI process. | |
| working_directory | No | Directory relative to the Claude project root, or an allowed absolute path. | . |
| acceptance_criteria | No | Observable conditions the specialist should satisfy. | |
| allow_concurrent_mutation | No | Allow simultaneous edits in one workspace only when file scopes are known not to overlap. |
delegate_frontendDelegate frontend and design work to KimiADestructive
Delegate product design, UX, visual systems, components, styling, accessibility, responsive behavior, animation, client state, or frontend-test work to Kimi. Use analyze/review for read-only work and implement for edits.
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Analyze/review are read-only; implement may edit the workspace. | implement |
| task | Yes | Concrete, self-contained specialist task. | |
| model | No | Optional provider-specific model override. | |
| context | No | Relevant architectural context, interfaces, decisions, and constraints. | |
| file_scope | No | Files or directories this specialist owns for this task. | |
| timeout_seconds | No | Hard timeout for the specialist CLI process. | |
| working_directory | No | Directory relative to the Claude project root, or an allowed absolute path. | . |
| acceptance_criteria | No | Observable conditions the specialist should satisfy. | |
| allow_concurrent_mutation | No | Allow simultaneous edits in one workspace only when file scopes are known not to overlap. |
specialist_statusCheck specialist availabilityARead-onlyIdempotent
Check whether the configured Codex, Kimi, and Grok CLIs are available. This does not verify account authentication.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
4 tool updates
v0.1.0- First observed
delegate_backend - First observed
delegate_build - First observed
delegate_frontend - First observed
specialist_status
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: specialist_status checks CLI availability, while delegate_backend, delegate_frontend, and delegate_build target different domains (backend, frontend, build). The descriptions explicitly state boundaries for each delegation tool, so there is no overlap.
The three delegate tools follow a consistent 'delegate_<domain>' pattern, but specialist_status diverges by using a noun-based name instead of a verb. This is a minor deviation that does not cause confusion.
Four tools is well-scoped for an orchestrator that delegates to three specialist CLIs and checks their availability. Each tool earns its place and there is no unnecessary bloat.
The tool surface covers status checking and delegation for all three specialist domains (Codex, Kimi, Grok Build), including read-only and implementation modes. No significant gaps are apparent for the stated purpose.
Maintenance
Related MCP Connectors
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
LLM Orchestration Agent (Mcp)
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server orchestrating local CLI agents (Claude Code, OpenAI Codex, Google Gemini) for cross-validation, second opinions, and persona-driven prompting.18MIT
- FlicenseAqualityCmaintenanceAn MCP server that orchestrates parallel Claude agent sessions by decomposing natural-language tasks into contract-bound tenants with structured outputs and validation, all running over stdio.5-
- AlicenseAqualityDmaintenanceMCP server that spawns autonomous Claude Code agents in GitHub repos, enabling task delegation with persistent state, multi-step workflows, and job monitoring.4776 npm2Apache 2.0
- FlicenseNot gradedqualityDmaintenanceMulti-model agent orchestration MCP server that enables plan-code-review-deliver pipelines with configurable providers and models.-