🏛️ Boardroom MCP

AI Governance-as-a-Service — Model Context Protocol Server

Give your AI agents a boardroom of advisors. Based on Napoleon Hill's Mastermind Principle — the idea that coordinated minds produce intelligence no single mind can achieve — digitized for AI agents.

Multi-advisor debate, institutional memory, trust scoring, and cognitive governance — all running locally on your machine.

📖 Read the Full Documentation →

Complete guide covering Quick Start → Installation → 5 Tools → Protocol Files → Building Councils → Debate Protocols → Cognitive Drills → Mind Versioning → Architecture → Full System.

⚡ Quick Start

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%/Claude/claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "boardroom": {
      "command": "npx",
      "args": ["-y", "boardroom-mcp"]
    }
  }
}

Restart Claude Desktop, then ask:

Board: Should I build a mobile app or PWA for my SaaS?

Claude Code (CLI)

Create .mcp.json in your project root:

{
  "mcpServers": {
    "boardroom": {
      "command": "npx",
      "args": ["-y", "boardroom-mcp"]
    }
  }
}

Or add it to your Claude Code settings via:

claude mcp add boardroom -- npx -y boardroom-mcp

Cursor / Windsurf

Add to your MCP settings (Settings → MCP):

{
  "mcpServers": {
    "boardroom": {
      "command": "npx",
      "args": ["-y", "boardroom-mcp"]
    }
  }
}

Antigravity

Add to your MCP configuration file:

{
  "mcpServers": {
    "boardroom": {
      "command": "npx",
      "args": ["-y", "boardroom-mcp"]
    }
  }
}

OpenClaw

Add to your ~/.openclaw/openclaw.json under the gateway's mcpServers key:

{
  "gateway": {
    "mcpServers": {
      "boardroom": {
        "command": "npx",
        "args": ["-y", "boardroom-mcp"]
      }
    }
  }
}

✅ Verify Installation

After configuring, ask your AI agent:

Use the analyze tool: "Test — is the Boardroom working?"

You should see output starting with # Boardroom Analysis listing the demo council advisors. If you see this, the server is working correctly.

📦 Alternative Installation Methods

# Option A: npx (used by MCP configs above — no global install needed)
npx -y boardroom-mcp

# Option B: Global install
npm install -g boardroom-mcp
boardroom-mcp

# Option C: Clone and build (for development/contributing)
git clone https://github.com/randysalars/boardroom-mcp.git
cd boardroom-mcp && npm install && npm run build

Note: Options A and B require the package to be published to npm. If npx fails, use Option C (clone and build), then point your MCP config to the local build:

{
  "mcpServers": {
    "boardroom": {
      "command": "node",
      "args": ["/path/to/boardroom-mcp/dist/index.js"]
    }
  }
}

🔧 5 MCP Tools

| Tool | Purpose | |------|---------| | analyze | Full boardroom consultation with multi-advisor debate | | check_governance | Task classification + severity routing | | query_intelligence | Search LEDGER decisions + Wisdom Codex | | trust_lookup | 6-dimension trust vector for any entity | | report_outcome | Log outcomes for institutional memory |

→ See detailed tool documentation with examples

🏗️ Architecture

Your AI Client (Claude, Cursor, Windsurf, Antigravity, OpenClaw)
         │ MCP Protocol (STDIO)
         │ Runs 100% on YOUR machine
         ▼
  Boardroom MCP Server
         │
         ├── demo/              ← Included demo council (5 advisors)
         │
         ▼
  ~/.ai/boardroom/          ← Full protocol files (optional upgrade)
  ├── LEDGER.md              ← Institutional memory
  ├── BOARD_WISDOM.md        ← Distilled principles
  └── mastermind/
      ├── seats/             ← Advisor definitions
      ├── councils/          ← Expert panels
      └── protocols/         ← Debate rules

Zero cost. No API keys. No cloud. No hosting. Your AI client does the LLM processing.

🎯 What You Get

Free (This Repo)

• ✅ MCP server with 5 tools
• ✅ Demo council (5 advisors: Strategist, Engineer, Skeptic, Visionary, Guardian)
• ✅ MIT license

Full System (salars.net/boardroom)

• 🏛️ 450+ named advisors with calibrated seat cards (Buffett, Torvalds, Aurelius...)
• 🏛️ 38 expert councils (Tech, Business, Survival, Legal, Creative...)
• ⚔️ 5 debate resolution types
• 🧠 10 cognitive drills
• ⏳ Mind Versioning (Young Jobs vs Late Jobs)
• 🔥 Prometheus Protocol (forge new domains on the fly)
• 👁️ Meta-Observer (real-time bias detection)
• 📚 69+ LEDGER decisions as precedent library
• 📖 113+ Wisdom Codex entries
• 🎯 Smart Router (auto-detects council + severity)

⚙️ Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | BOARDROOM_ROOT | ~/.ai/boardroom | Path to your full protocol files directory | | SALARSNET_ROOT | (auto-detect) | Root project directory |

🔍 Troubleshooting

| Problem | Solution | |---------|----------| | npx boardroom-mcp fails | Package may not be published yet — use Option C (clone and build) | | "No advisors found" | Demo council ships with the package. Check demo/seats.md exists | | Tools don't appear in Claude | Restart Claude Desktop after editing config. Check JSON syntax. | | ENOENT errors | If using full protocol files, set BOARDROOM_ROOT to your .ai/boardroom path |

📬 Stay in the Loop

• 🌐 Landing Page — Feature overview + waitlist
• 📖 Documentation — Complete free → advanced guide
• 📧 Subscribe for Updates — New councils, protocol updates, features
• 🐦 @SalarsNet — Tips, demos, and announcements

🤝 Contributing

PRs welcome! Areas we'd love help with:

• Additional demo advisors
• New cognitive drill templates
• Documentation improvements
• Bug fixes

📄 License

MIT — Built by SalarsNet