# The High Council

> The High Council is an open-source MCP server for ai models and llm tooling. Models from several labs debate, review and sign off a software plan before you build. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://sower-industries.de/en/THC/
- **Repository:** https://github.com/muad-yasin/the-high-council-mcp
- **MCP Registry name:** io.github.muad-yasin/the-high-council
- **Categories:** AI models and LLM tooling, developer tools
- **Listing updated:** 2026-11-15

## About

The High Council turns a project idea into a written plan by making models argue about it. Your request is first converted into yes/no criteria the plan must pass. Each lab's model then proposes blindly, reads the others with names hidden, and posts support, objections or merges; every author keeps, amends or withdraws its own proposal on the record.

Judges review the draft in three layers and send failed checks back for revision. Unsettled objections stay visible rather than being averaged away. Each run writes a runs/ folder with the plan, the full debate board, a HANDOFF.md with acceptance checks and instructions for a coding agent, and a JSON report with token and cost accounting.

It is open source and uses your own API keys for Anthropic, OpenAI, Google, Mistral, DeepSeek, Groq, Together, Cohere, OpenRouter or Z.ai, needed only for chains that seat those models. A spend limit stops a run before any call estimated to pass it. The README states plainly that effectiveness numbers are not yet measured. A keyless demo runs with npx the-high-council council demo.

## Features

- **Criteria first:** Turns the request into yes/no checks before anyone plans.
- **Blind proposals:** Each lab proposes without seeing the others, then debates with names hidden.
- **Three judge layers:** Judges must sign off before the plan counts as ready to build.
- **Recorded disagreement:** Objections and withdrawals stay on the board.
- **Build handoff:** Writes HANDOFF.md with acceptance checks for a coding agent.
- **Spend limit:** Stops a run before a call that would pass the limit.

## Good for

- Plan a new feature before a coding agent builds it
- Stress-test a software design with several model families
- Get acceptance checks for a handoff
- See which model objected to which part of a plan
- Try the debate offline with the demo

## Install

### Claude Code (Terminal)

```sh
claude mcp add the-high-council --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env GOOGLE_API_KEY='<GOOGLE_API_KEY>' --env MISTRAL_API_KEY='<MISTRAL_API_KEY>' --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' --env GROQ_API_KEY='<GROQ_API_KEY>' --env TOGETHER_API_KEY='<TOGETHER_API_KEY>' --env COHERE_API_KEY='<COHERE_API_KEY>' --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' --env ZAI_API_KEY='<ZAI_API_KEY>' -- npx -y the-high-council
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "the-high-council": {
      "command": "npx",
      "args": [
        "-y",
        "the-high-council"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "GROQ_API_KEY": "<GROQ_API_KEY>",
        "TOGETHER_API_KEY": "<TOGETHER_API_KEY>",
        "COHERE_API_KEY": "<COHERE_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
        "ZAI_API_KEY": "<ZAI_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "the-high-council": {
      "command": "npx",
      "args": [
        "-y",
        "the-high-council"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "GROQ_API_KEY": "<GROQ_API_KEY>",
        "TOGETHER_API_KEY": "<TOGETHER_API_KEY>",
        "COHERE_API_KEY": "<COHERE_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
        "ZAI_API_KEY": "<ZAI_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "the-high-council": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "the-high-council"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "GROQ_API_KEY": "<GROQ_API_KEY>",
        "TOGETHER_API_KEY": "<TOGETHER_API_KEY>",
        "COHERE_API_KEY": "<COHERE_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
        "ZAI_API_KEY": "<ZAI_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "the-high-council": {
      "command": "npx",
      "args": [
        "-y",
        "the-high-council"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "GROQ_API_KEY": "<GROQ_API_KEY>",
        "TOGETHER_API_KEY": "<TOGETHER_API_KEY>",
        "COHERE_API_KEY": "<COHERE_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
        "ZAI_API_KEY": "<ZAI_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "the-high-council": {
      "command": "npx",
      "args": [
        "-y",
        "the-high-council"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "GROQ_API_KEY": "<GROQ_API_KEY>",
        "TOGETHER_API_KEY": "<TOGETHER_API_KEY>",
        "COHERE_API_KEY": "<COHERE_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
        "ZAI_API_KEY": "<ZAI_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Does it cost anything?

The tool is free and open source; you pay your model providers through your own API keys.

### Can I try it without keys?

Yes, npx the-high-council council demo needs no keys or network.

### How is spend controlled?

A per-run limit stops a run before a call estimated to exceed it; COUNCIL_MAX_USD_LIMIT sets a ceiling clients cannot raise.

### Does it prove better plans?

The README says exact effectiveness numbers are not measured yet.

### Is The High Council free?

Yes. The High Council is open source, so you can use and self-host it for free.

### How do I add The High Council to Claude Code?

Run this command in your terminal: claude mcp add the-high-council --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env GOOGLE_API_KEY='<GOOGLE_API_KEY>' --env MISTRAL_API_KEY='<MISTRAL_API_KEY>' --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' --env GROQ_API_KEY='<GROQ_API_KEY>' --env TOGETHER_API_KEY='<TOGETHER_API_KEY>' --env COHERE_API_KEY='<COHERE_API_KEY>' --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' --env ZAI_API_KEY='<ZAI_API_KEY>' -- npx -y the-high-council

### What are the best alternatives to The High Council?

The closest alternatives to The High Council are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/the-high-council
