Legion MCP Server

by faulkjio.github.faulkj/legionv0.8.0

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

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active3d ago

Install Legion MCP server

claude mcp add legion-faulkj -e MCP_TRANSPORT='<mcp-transport>' -e DEFAULT_API_KEY='<default-api-key>' -e ALLOW_NO_MODELS='<allow-no-models>' -e OPENAI_API_KEY='<openai-api-key>' -- npx -y legion-mcp

{
  "mcpServers": {
    "legion-faulkj": {
      "command": "npx",
      "args": [
        "-y",
        "legion-mcp"
      ],
      "env": {
        "MCP_TRANSPORT": "<mcp-transport>",
        "DEFAULT_API_KEY": "<default-api-key>",
        "ALLOW_NO_MODELS": "<allow-no-models>",
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "legion-faulkj": {
      "command": "npx",
      "args": [
        "-y",
        "legion-mcp"
      ],
      "env": {
        "MCP_TRANSPORT": "<mcp-transport>",
        "DEFAULT_API_KEY": "<default-api-key>",
        "ALLOW_NO_MODELS": "<allow-no-models>",
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "legion-faulkj": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "legion-mcp"
      ],
      "env": {
        "MCP_TRANSPORT": "<mcp-transport>",
        "DEFAULT_API_KEY": "<default-api-key>",
        "ALLOW_NO_MODELS": "<allow-no-models>",
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "legion-faulkj": {
      "command": "npx",
      "args": [
        "-y",
        "legion-mcp"
      ],
      "env": {
        "MCP_TRANSPORT": "<mcp-transport>",
        "DEFAULT_API_KEY": "<default-api-key>",
        "ALLOW_NO_MODELS": "<allow-no-models>",
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MCP_TRANSPORT	yes	—	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	—	yes	Default provider or gateway key for model files that omit apiKey.
ALLOW_NO_MODELS	yes	—	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	—	yes	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.
ASYNC_TOOLS	—	—	Run councils in the background: council tools return a job handle and poll/cancel tools are exposed. Jobs live in process memory only.
TRUST_PROXY_AUTH	—	—	Bind async jobs to the caller named by X-MS-CLIENT-PRINCIPAL-* headers. Only safe behind an ingress that strips client-supplied copies.

Freshness

Active — last maintenance signal 3d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-06 · 3d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-06 · 3d ago · official registry · v0.8.0

FAQ

›How do I install the Legion MCP server in Claude Code?

Run: claude mcp add legion-faulkj -e MCP_TRANSPORT='<mcp-transport>' -e DEFAULT_API_KEY='<default-api-key>' -e ALLOW_NO_MODELS='<allow-no-models>' -e OPENAI_API_KEY='<openai-api-key>' -- npx -y legion-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Legion require an API key?

Yes. It expects MCP_TRANSPORT, ALLOW_NO_MODELS, DEFAULT_API_KEY, OPENAI_API_KEY, of which 2 are secrets.

›Can I use Legion as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Legion in the official MCP registry?

Yes, as io.github.faulkj/legion.