The Council

The Council

[](https://www.npmjs.com/package/council-mcp) [](https://github.com/iamvirul/the-council/pkgs/npm/council-mcp) [](https://github.com/iamvirul/the-council/actions/workflows/ci.yml) [](https://opensource.org/licenses/MIT)

A four-tier AI agent orchestration system built as a Claude Code MCP server.

The Council is a TypeScript [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server with four Claude agents. When you give it a problem, it figures out the complexity and sends it to the right agents. A formatting task goes straight to the fast Aide (Haiku). A coding task goes to the Executor (Sonnet). A design or architecture problem first goes through the Chancellor (Opus) for a plan, then the Executor runs each step, delegating simple sub-tasks to the Aide. After each Executor or Aide output, the Supervisor (Haiku) acts as an active quality gate — rejecting outputs that miss the mark and triggering a retry with its feedback attached, up to a configurable limit.

Sub-agents run via the `claude` CLI — the same one Claude Code uses. **If you already have Claude Code installed, no separate API key or extra cost is needed.** The install script finds the `claude` binary and wires it up automatically. Alternatively, set `ANTHROPIC_API_KEY` in the MCP server env for CI or API-key-based setups.

---

How It Works

Complexity routing uses a fast keyword + word count check with no extra LLM call.

Signal	Complexity	Agents invoked
Word count > 60, or keywords: plan, design