DebateTalk MCP

DebateTalk MCP

Official MCP server and CLI for DebateTalk — run structured multi-model AI debates from your AI assistant or terminal.

DebateTalk makes multiple AI models argue a question independently, challenge each other's reasoning, and converge on a structured synthesis: Strong Ground, Fault Lines, Blind Spots, and Your Call.

Features

• MCP server — connect Claude Desktop, Cursor, or any MCP-compatible client to DebateTalk
• CLI — run debates and check model status from the terminal
• Streaming output — debates stream in real time via SSE
• 5 tools: run_debate, get_model_status, recommend_models, estimate_cost, get_history

Quickstart

MCP (Claude Desktop / Cursor)

1. Get an API key

Create a key at console.debatetalk.ai/api-keys. Requires a Pro or Enterprise plan. Free tier: 5 debates/day.

2. Add to your MCP client config

{
  "mcpServers": {
    "debatetalk": {
      "command": "npx",
      "args": ["-y", "@debatetalk/mcp"],
      "env": {
        "DEBATETALK_API_KEY": "dt_your_key_here"
      }
    }
  }
}

Config file locations:

• Claude Desktop (Mac): ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
• Cursor: .cursor/mcp.json in your project root

3. Ask Claude to run a debate

Claude reads the tool description to decide when to call it — no exact phrasing required. Any of these work:

"debate whether we should rewrite our backend in Go""use DT — should we raise our Series A now?""multi-model this: is Rust worth learning in 2026?""stress-test this architecture decision""get a second opinion on moving to microservices"

Claude will also invoke it proactively for high-stakes decisions where a single AI answer is insufficient.

CLI

Install globally:

npm install -g @debatetalk/mcp

Set your API key:

export DEBATETALK_API_KEY=dt_your_key_here

Run a debate:

debatetalk debate "Should we adopt microservices?"

Check which models are online:

debatetalk models

Get a recommended model panel for your question:

debatetalk recommend "Is Rust worth learning in 2026?"

Estimate cost before running:

debatetalk cost "Should we raise our Series A now?"

View past debates:

debatetalk history
debatetalk history --limit 5

MCP Tools Reference

run_debate

question     string   required   The question or topic to debate
models       array    optional   Specific model IDs to use (omit for smart routing)
rounds       number   optional   Number of deliberation rounds (default: 2)

get_model_status

No parameters. Returns live health, latency, and uptime per model.

recommend_models

question     string   required   The question — routing picks the strongest panel

estimate_cost

question     string   required
models       array    optional
rounds       number   optional

get_history

limit        number   optional   Number of debates to return (default: 20, max: 100)

Configuration

Public tools (get_model_status, recommend_models) work without an API key.

Plans & Limits

Full pricing →

Development

git clone https://github.com/DebateTalk-AI/mcp
cd debatetalk-mcp
npm install
npm run build
npm test

Run MCP server locally:

DEBATETALK_API_KEY=dt_your_key npm run dev:mcp

Run CLI locally:

DEBATETALK_API_KEY=dt_your_key npm run dev:cli -- debate "your question"

Contributing

See CONTRIBUTING.md. Issues and PRs welcome.

License

MIT — see LICENSE.