Skip to main content

AI Council MCP Server

Multi-AI Consensus Tool: Query multiple AI models in parallel, synthesize responses for better accuracy, and reduce AI bias through ensemble decision-making.

AI Council is a powerful MCP (Model Context Protocol) server that harnesses the "wisdom of crowds" by consulting multiple AI models simultaneously. Get more reliable, comprehensive answers by combining insights from OpenAI, Claude, Gemini, and any OpenAI-compatible API.

✨ What is AI Council?

AI Council transforms how you interact with AI by:

  • 🔄 Parallel Processing: Queries multiple AI models simultaneously (not sequentially)
  • 🎯 Bias Reduction: Uses anonymous code names to prevent synthesis bias
  • ⚡ Smart Synthesis: One model synthesizes all responses into a comprehensive answer
  • 🔧 Universal Compatibility: Works with OpenAI, OpenRouter, and any OpenAI-compatible API
  • 🛡️ Robust Error Handling: Graceful degradation when individual models fail

Perfect for: Research questions, complex analysis, creative projects, technical decisions, and any task where multiple AI perspectives add value.

📋 Requirements

  • Python 3.10+
  • uv installed (installation guide)
  • alternatively:
    • pipx installed (installation guide), update config
        "command": "pipx",
        "args": ["run", "ai-council"]
      
    • or manual install wiht pip install ai-council, and update config
      "command": "ai-council",
      "args": []
      

🚀 Quick Start

  1. Get your OpenRouter api key

Cursor IDE Setup

  1. Open Cursor Settings → MCP
  2. Add new MCP server and set your api key:
{
  "ai-council": {
    "command": "uvx",
    "args": ["ai-council"],
    "env": {
      "OPENROUTER_API_KEY": "..."
    }
  }
}

Claude Desktop Setup

  1. Edit ~/.claude_desktop_config.json and set your api key:
{
  "mcpServers": {
    "ai-council": {
      "command": "uvx",
      "args": ["ai-council"],
      "env": {
        "OPENROUTER_API_KEY": "..."
      }
    }
  }
}

That's it! Ask any complex question and the AI Council tool will automatically engage multiple models.

By default it will use OpenRouter with Claude Sonnet 4, Gemini 2.5 Pro, and DeepSeek V3.

CLI Arguments

Use command-line arguments for quick setup, add any of these to the args in you mcp config:

Available CLI Arguments:

  • --openai-api-key: Your OpenAI API key
  • --openrouter-api-key: Your OpenRouter API key
  • --max-models: Maximum models to query (default: 3)
  • --parallel-timeout: Timeout in seconds (default: 60)
  • --log-level: Logging level (DEBUG, INFO, WARNING, ERROR)
  • --config: Path to custom config file

⚙️ Advanced Configuration

For advanced setups, create a config.yaml file and link to it with --config path/to/config.yaml:

# config.yaml
openai_api_key: "your_openai_key_here"
openrouter_api_key: "your_openrouter_key_here"
max_models: 3
parallel_timeout: 90 # in seconds
synthesis_model_selection: "random"  # or "first"

models:
  # use OpenAI API
  - name: "GPT-4o"
    provider: "openai" 
    model_id: "gpt-4o"
    enabled: true # optional, defaults to true
    
  # use OpenRouter API
  - name: "Claude Sonnet"
    provider: "openrouter"
    model_id: "anthropic/claude-3.5-sonnet"
    code_name: "Bob" # optional, auto assigned otherwise
  
  # or any custom OpenAI compatible API
  - name: "Perplexity"
    provider: "custom"
    model_id: "llama-3.1-sonar-large-128k-online"
    base_url: "https://api.perplexity.ai"
    api_key: "your_perplexity_key_here"
    
  # Local LLM (Ollama)
  - name: "Local Llama"
    provider: "custom" 
    model_id: "llama-3b"
    base_url: "http://localhost:11434"
    api_key: "key-if-needed"

📖 How It Works

AI Council uses a sophisticated three-phase approach:

1. Parallel Consultation

  • Simultaneously queries your configured AI models
  • Maintains the same context and question for each model
  • Handles failures gracefully (continues with successful responses)

2. Anonymous Analysis

  • Assigns code names (Alpha, Beta, Gamma, etc.) to each model's response
  • Prevents synthesis bias toward specific brands or providers
  • Preserves response quality while removing model identity

3. Smart Synthesis

  • Randomly selects one model to act as the synthesizer
  • Synthesizer analyzes all anonymous responses
  • Produces a comprehensive answer combining the best insights

🤝 Acknowledgments

This project was inspired by Cognition Wheel.

AI Council extends these ideas with:

  • Enhanced configuration flexibility
  • OpenRouter support for many model options with a single api key
  • Support for custom API endpoints
  • Improved error handling and logging
  • Using Python

Metadata

Release files for ai-council 0.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ai-council 0.2.3
File Size Uploaded
ai_council-0.2.3.tar.gz 14.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ai-council 0.2.3
File Interpreter ABI Platform
ai_council-0.2.3-py3-none-any.whl Python 3 none any Details

Total release size: 31.5 kB

Release files / ai_council-0.2.3.tar.gz

Download URL ai_council-0.2.3.tar.gz
Size 14.0 kB
Tags Source
SHA-256 checksum
How to use checksums
2bfbc329254f20331ae2eccb48280b87e89f3bb7e574b1533528a6d5f6add36c
BLAKE2b-256 checksum
How to use checksums
472305ee1b44cc90bb29c663b6c140dfc7690c56d9ca69c8b3c8ad4bd59c7131
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.14

Release files / ai_council-0.2.3-py3-none-any.whl

Download URL ai_council-0.2.3-py3-none-any.whl
Size 17.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9382717692743d957000603cae0bb293a419ddef54a3288ad88acdb58727f954
BLAKE2b-256 checksum
How to use checksums
e35770eb5f55b3d3835fcefe2083c081c8aee83ed068a1c4e2c548045452eede
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.14

Release history Release notifications | RSS feed

This release

0.2.3 This release

2 release files

0.2.2

2 release files

0.2.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page