io.github.faulkj/legion MCP Server

io.github.faulkj/legion

Repository Registry

What is the io.github.faulkj/legion MCP server?

MCP-native LLM councils for debates, juries, blind panels, refinement, and custom deliberation.

How to install io.github.faulkj/legion

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MCP_TRANSPORT
required
Run the installed package over MCP stdio (the binary defaults to HTTP).
DEFAULT_BASE_URL
Default OpenAI Responses-compatible API root for model files that omit baseUrl.
DEFAULT_API_KEY
secret
Default provider or gateway key for model files that omit apiKey.
ALLOW_NO_MODELS
required
Boot without any config/models/*.json. The package ships only key-free examples, which the scanner ignores, so this must stay true until a real model file exists beside the working directory.
OPENAI_API_KEY
secret
Optional. A model file's apiKey may be "env:VAR" to read the key from an environment variable named VAR at startup; name those variables here as needed. The bundled gpt example reads this one.
MAX_ROUNDS
Maximum discussion rounds accepted by a council run.
TOKEN_BUDGET
Optional soft cumulative token budget for a council run.
DYNAMIC_ROLES
Allow callers to define ad-hoc council roles inline.
LOG_LEVEL
Logging verbosity. Logs are written to stderr for stdio safety.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "legion": {
      "command": "npx",
      "args": [
        "-y",
        "legion-mcp"
      ],
      "env": {
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "DEFAULT_BASE_URL": "<YOUR_DEFAULT_BASE_URL>",
        "DEFAULT_API_KEY": "<YOUR_DEFAULT_API_KEY>",
        "ALLOW_NO_MODELS": "<YOUR_ALLOW_NO_MODELS>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "MAX_ROUNDS": "<YOUR_MAX_ROUNDS>",
        "TOKEN_BUDGET": "<YOUR_TOKEN_BUDGET>",
        "DYNAMIC_ROLES": "<YOUR_DYNAMIC_ROLES>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}