foo-mcp

# FOO MCP `foo-mcp` exposes FOO-style multiagent orchestration as a Model Context Protocol server. Peer agents critique each other, harmonizer agents organize the critiques, and the target agent revises based on the consensus — every step written to a hash-chained, JSONL trace ledger so the full reasoning history is reproducible and auditable. Supports OpenAI, Anthropic, Google Gemini, Hugging Face, and Apple Silicon MLX local inference behind a single config schema. --- ## Quick start ```bash # 1. Install pip install foo-mcp # or: uvx foo-mcp # 2. Export the API keys for the providers you want to use export ANTHROPIC_API_KEY=sk-ant-... export OPENAI_API_KEY=sk-... # 3. Pick at least two providers + models interactively foo-mcp-init # writes ~/.config/foo-mcp/agents.json export FOO_MCP_CONFIG=~/.config/foo-mcp/agents.json # 4. Smoke-test the full multi-agent pipeline against real LLMs foo-mcp-consensus-demo --question "What is the half-life of caffeine?" ``` The server requires at least two usable non-mock agents at startup; without them it exits with a clear error pointing back at `foo-mcp-init`. See [Startup quorum](#startup-quorum) for the override. --- ## Install in 60 seconds ### Option A — Add to Claude Code via PyPI (recommended) ```bash claude mcp add --scope user --transport stdio foo-mcp \ --env OPENAI_API_KEY=$OPENAI_API_KEY \ --env ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \ --env GEMINI_API_KEY=$GEMINI_API_KEY \ --env HF_TOKEN=$HF_TOKEN \ --env FOO_MCP_CONFIG=$HOME/.config/foo-mcp/agents.json \ -- uvx foo-mcp ``` Pass keys as bare values — `KEY=sk-abc123`, not `KEY="sk-abc123"`. Wrapping quote characters are passed through to provider SDKs and cause silent 401s. Only pass `--env` lines for the providers whose keys you actually have. Use `--scope local` instead of `--scope user` to limit registration to the current project. ### Option B — Add to Claude Code via Git (track main directly) If you w…