# roundtable-mcp

An MCP server that lets Claude orchestrate multi-model AI roundtable discussions between **GPT-4o**, **Gemini 2.0 Flash**, **Grok-3**, and **DeepSeek-R1**.

## How It Works

**Round 1 — Independent Responses:** Each model answers the prompt independently, with no awareness of the others.

**Round 2 — Cross-Critique:** Every model sees all Round 1 responses and provides critique, refinement, or synthesis.

## Tools

| Tool | Description |
|------|-------------|
| `roundtable_discuss` | Full 2-round discussion with configurable presets |
| `roundtable_quick` | Single-round quick poll (no cross-critique) |
| `roundtable_models` | List available models and API key status |
| `roundtable_presets` | List available discussion presets |

## Presets

- **debate** — Structured debate with strong positions
- **brainstorm** — Creative ideation session
- **analysis** — Deep analytical examination
- **devil** — Devil's advocate challenges
- **consensus** — Seek common ground and synthesize

## Installation

```bash
git clone https://github.com/brandondek/roundtable-mcp.git
cd roundtable-mcp
pip install -e .
```

## API Keys

Set the following environment variables for each model you want to use:

```
OPENAI_API_KEY=sk-...          # GPT-4o
GEMINI_API_KEY=AI...           # Gemini 2.0 Flash
XAI_API_KEY=xai-...            # Grok-3
DEEPSEEK_API_KEY=sk-...        # DeepSeek-R1
```

Models without a configured API key will be skipped gracefully.

## Claude Desktop Configuration

Add this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "roundtable": {
      "command": "roundtable-mcp",
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "GEMINI_API_KEY": "AI...",
        "XAI_API_KEY": "xai-...",
        "DEEPSEEK_API_KEY": "sk-..."
      }
    }
  }
}
```

## Usage Examples

Once installed, ask Claude:

- *"Run a roundtable debate on whether AI will replace software engineers"*
- *"Quick poll all models: what's the best programming language for beginners?"*
- *"Brainstorm session on novel uses for LLMs in healthcare"*
- *"Devil's advocate discussion on remote work vs office"*

## License

MIT