council-mcp
Three-tier AI agent MCP orchestration system: Chancellor (Opus), Executor (Sonnet), Aide (Haiku)
Description
Three-tier AI agent MCP orchestration system: Chancellor (Opus), Executor (Sonnet), Aide (Haiku)
Release History
| Version | Changes | Urgency | Date |
|---|---|---|---|
| 0.4.0 | Imported from npm (0.4.0) | Low | 4/21/2026 |
| v0.4.0 | ### Added - **Per-agent tool access** — Chancellor and Aide now have tool access, configurable via `AGENT_TOOLS` constants: - Chancellor: `Read`, `Glob`, `Grep` (read-only — inspects codebase before planning, never writes) - Executor: `Read`, `Write`, `Edit`, `Bash`, `Glob`, `Grep` (unchanged) - Aide: `Read` (can read files before transforming them) - Supervisor: none (pure review, no side effects) - `AGENT_TOOLS` constant in `src/domain/constants/index.ts` — single source of truth for | High | 4/20/2026 |
| v0.3.0 | ### Added - **Persistent session memory** — sessions now survive MCP server restarts via an optional `COUNCIL_PERSIST` env var: - `memory` (default) — in-process LRU Map, no breaking change - `file` — JSON files at `~/.council/sessions/<id>.json`, zero dependencies - `sqlite` — SQLite at `~/.council/council.db` via `better-sqlite3`, WAL mode for safe concurrent access - **`SessionStore` interface** — all backends implement a common contract; swappable without touching orchestration code - | High | 4/17/2026 |
| v0.2.3 | ### Changed - README diagrams replaced with hosted images — architecture, orchestration flow, and session lifecycle diagrams now render correctly on all platforms including GitHub, npm, and PyPI mirrors --- **Install:** `npm install council-mcp` **Use in Claude Code MCP config:** ```json { "mcpServers": { "the-council": { "command": "npx", "args": ["-y", "council-mcp"] } } } ``` | Medium | 4/12/2026 |
| v0.2.2 | ### Fixed - `install.sh` now also runs `claude mcp add` to register the server with Claude Code CLI — previously only Claude Desktop was configured, so the tools were invisible in the CLI - `install.ps1` rewritten to match: detects `claude` binary, falls back to `ANTHROPIC_API_KEY`, configures both Claude Desktop and Claude Code CLI - `runner.ts` strips `ANTHROPIC_API_KEY` when set to an empty string — Claude Desktop injects an empty key into the MCP server env, causing the child `claude` proce | Medium | 4/12/2026 |
| v0.2.1 | ### Fixed - Replace `@anthropic-ai/claude-agent-sdk` with direct `claude` CLI subprocess calls — eliminates 401 auth errors for users authenticated via Claude.ai OAuth (no separate API key needed) - Use `--system-prompt-file` instead of `--system-prompt` CLI arg — prevents `exit 1` failures caused by long system prompts with XML tags and special characters - Startup check fails fast with a clear message if `claude` CLI is not in PATH and no `ANTHROPIC_API_KEY` is set - `install.sh` and `install | Medium | 4/12/2026 |
| v0.2.0 | ### Added - **Supervisor agent** (Claude Haiku 4.5) — reviews every Executor step result and Aide task output before they surface to the caller. Non-blocking: if the Supervisor errors, orchestration continues and a warning is logged. - **`get_supervisor_verdicts` MCP tool** — retrieve all Supervisor verdicts for a session, with optional `flagged_only` filter for quick triage - **Supervisor flags in result summary** — flagged outputs appear under a `## Supervisor Flags` section in the `orchestra | Medium | 4/11/2026 |
| v0.1.2 | ### Fixed - Release workflow now reconfigures npm registry to `npm.pkg.github.com` before publishing to GitHub Packages, fixing `ENEEDAUTH` on the GitHub Packages publish step --- **Install:** `npm install council-mcp` **Use in Claude Code MCP config:** ```json { "mcpServers": { "the-council": { "command": "npx", "args": ["-y", "council-mcp"] } } } ``` | Medium | 4/11/2026 |
| v0.1.0 | ### Added - **MCP server** with five tools: `orchestrate`, `consult_chancellor`, `execute_with_executor`, `delegate_to_aide`, `get_council_state` - **Chancellor agent** (Claude Opus 4.6) — strategic analysis, risk assessment, and step-by-step planning via the Agent SDK - **Executor agent** (Claude Sonnet 4.6) — plan implementation with access to `Read`, `Write`, `Edit`, `Bash`, `Glob`, `Grep` tools - **Aide agent** (Claude Haiku 4.5) — simple tasks: formatting, data transformation, utilities - | Medium | 4/11/2026 |
Dependencies & License Audit
Loading dependencies...
Similar Packages
automagik-genieSelf-evolving AI agent orchestration framework with Model Context Protocol support2.5.27
agent-link-mcpMCP server for bidirectional AI agent collaboration — spawn and communicate with any AI coding agent CLI0.5.0
@claude-flow/cliRuflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code3.5.80