Skip to main content
Glama

Conclave MCP

「AIの合議体(conclave)」へのアクセスを提供するMCP(Model Context Protocol)サーバーです。MCP対応クライアントから複数の最先端モデルに相談し、多様な意見、ピアランキングによる評価、統合された回答を得ることができます。

なぜこれが必要なのか

AIアシスタントを利用する際、通常は1つのモデルの視点しか得られません。それが適切な場合もありますが、技術アーキテクチャ、ビジネス戦略、クリエイティブな方向性、複雑な分析など、盲点が許されない重要な意思決定においては、複数の意見を検討することで見落としを防ぐことができます。

Conclaveは、民主的なAIの合意形成をあらゆるワークフローにもたらします。

複数のAIサービスに手動で問い合わせる代わりに、Claude Desktop、Claude Code、または任意のMCPクライアントを通じてConclaveに相談できます。複数の最先端モデル(GPT、Claude、Gemini、Grok、DeepSeek)からランク付けされた意見を取得し、AIの集合知を代表する統合された回答を受け取ることができます。

主なユースケース:

  • 技術: アーキテクチャの決定、コードレビュー、デバッグ、API設計

  • ビジネス: 戦略分析、提案書のレビュー、市場調査の統合

  • クリエイティブ: ライティングのフィードバック、ブレインストーミング、編集的視点

  • 研究: 文献レビュー、ファクトチェック、多角的な分析

  • 意思決定: メリット・デメリット分析、リスク評価、選択肢の評価

Andrej Karpathy氏のllm-councilのコンセプトに着想を得ています。本プロジェクトは、AI支援ワークフローへのシームレスな統合のために、その核となるアイデアをMCPサーバーとして再実装したものです。

Related MCP server: AI Council MCP Server

仕組み

Conclaveは最大3つのステージで動作します。

┌─────────────────────────────────────────────────────────────────┐
│  Stage 1: OPINIONS                                              │
│  Query multiple LLMs in parallel for independent responses      │
│  (GPT, Claude, Gemini, Grok, DeepSeek, etc.)                   │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│  Stage 2: PEER RANKING                                          │
│  Each model anonymously evaluates and ranks all responses       │
│  Aggregate scores reveal best performers (lower = better)       │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│  Stage 3: SYNTHESIS                                             │
│  Chairman model synthesizes final answer from collective wisdom │
│  Consensus level reported (strong/moderate/weak/split)          │
│  Tiebreaker vote cast if conclave is split                      │
└─────────────────────────────────────────────────────────────────┘

機能

  • 階層化されたクエリ: コストと深さのトレードオフを選択可能(quick | ranked | full)

  • 3つの評議会階層: プレミアム(最先端)、スタンダード(バランス型)、バジェット(高速・安価)

  • 合意プロトコル: 合意レベルを検出し、意見が割れた場合はタイブレーカー(決選投票)をトリガー

  • 奇数の評議会サイズ: タイブレーカー投票でデッドロックを確実に回避

  • 議長のローテーション: 毎週のローテーションにより、単一モデルのバイアスを防止

  • 議長プリセット: コンテキストに応じた議長選択(コード、クリエイティブ、推論)

  • コスト見積もり: クエリ実行前にコストを把握可能

  • Eval-light: 時間経過に伴うパフォーマンスを追跡するためのスタンドアロン型ベンチマーク実行ツール

インストール

前提条件

  1. https://openrouter.ai/keys からOpenRouter APIキーを取得する

  2. OpenRouterアカウントにクレジットを追加する(従量課金制)

セットアップ

# Clone the repository
git clone https://github.com/stephenpeters/conclave-mcp.git
cd conclave-mcp

# Install dependencies
uv sync

# Optional: Create .env file for running tests locally
# (Not required for MCP usage - API key is passed via client config)
echo "OPENROUTER_API_KEY=sk-or-v1-your-key-here" > .env

Claude Desktopの設定

オプション1: デスクトップ拡張機能(推奨)

  1. Claude Desktopを開く

  2. Settings > Extensions > Advanced settings > Install Extension... に移動

  3. conclave-mcp ディレクトリを選択

  4. プロンプトに従って OPENROUTER_API_KEY を設定

  5. Claude Desktopを再起動

オプション2: 手動設定

Claude Desktopを開き、Settings > Developer > Edit Config に移動して、claude_desktop_config.json に以下を追加します:

{
  "mcpServers": {
    "conclave": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/conclave-mcp", "python", "server.py"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-your-key-here"
      }
    }
  }
}

/path/to/conclave-mcp を実際のパスに置き換え、保存してClaude Desktopを再起動してください。

Claude Codeの設定

CLIを使用してサーバーを追加します:

claude mcp add --transport stdio conclave -- uv run --directory /path/to/conclave-mcp python server.py --env OPENROUTER_API_KEY=sk-or-v1-your-key-here

または、.mcp.json.example.mcp.json にコピーしてパスを更新します:

cp .mcp.json.example .mcp.json
# Edit .mcp.json with your paths and API key

Claude Code内で /mcp を実行するか、ターミナルで claude mcp list を実行して確認してください。

利用可能なツール

conclave_quick

高速な並列意見収集(ステージ1のみ)。すべてのConclaveモデルに問い合わせ、個別の回答を返します。

コスト: クエリあたり約$0.01-0.03

用途: クイックなブレインストーミング、多様な視点を素早く得る

conclave_ranked

ピアランキング付きの意見収集(ステージ1 + 2)。特定の質問に対してどのモデルが最も優れたパフォーマンスを発揮したかを表示します。

コスト: クエリあたり約$0.05-0.10

用途: コードレビュー、アプローチの比較、どのモデルが「勝った」かを確認する

conclave_full

統合を含む完全なConclave(全3ステージ)。合意検出と議長によるタイブレーカーを含みます。

コスト: クエリあたり約$0.10-0.20

オプション:

  • tier: モデル階層 - "premium", "standard"(デフォルト), "budget"

  • chairman: 議長モデルの上書き(例: "anthropic/claude-sonnet-4"

  • chairman_preset: プリセットの使用("code", "creative", "reasoning", "concise", "balanced"

用途: 重要な意思決定、アーキテクチャの選択、複雑なデバッグ

conclave_config

現在の設定(Conclaveメンバー、議長ローテーション状況、合意しきい値)を表示します。

conclave_estimate

クエリ実行前にコストを見積もります。

conclave_models

選択番号付きの利用可能な全モデルをリスト表示します。モデルは階層ごとにグループ化され、安定した番号が割り当てられています:

  • プレミアム階層: 1-10

  • スタンダード階層: 11-20

  • バジェット階層: 21-30

  • 議長プール: 31-40

conclave_select

モデル番号からカスタムConclaveを作成します。最初のモデルが議長になります。

conclave_select(models="31,1,11,21")

作成例:

  • 議長: #31 (deepseek-r1)

  • メンバー: #1 (claude-opus-4.5), #11 (claude-sonnet-4.5), #21 (gemini-2.5-flash)

カスタム選択は、サーバーの再起動または conclave_reset が実行されるまで保持されます。

conclave_reset

カスタムConclave選択をクリアし、階層ベースの設定に戻します。

カスタムモデル選択

Conclaveに参加するモデルを完全に制御するには:

  1. 利用可能なモデルをリスト表示: conclave_models を使用して、すべてのモデルと番号を確認します

  2. ラインナップを選択: conclave_select(models="31,1,11,21") を使用します(最初の番号が議長です)

  3. クエリ: 通常通り conclave_quickconclave_ranked、または conclave_full を使用します

  4. リセット: conclave_reset を使用して階層ベースの設定に戻します

ワークフロー例:

> conclave_models
## Available Models
### Premium Tier (1-10)
   1. anthropic/claude-opus-4.5
   2. google/gemini-3-pro-preview
   ...

> conclave_select(models="31,1,12,21")
## Custom Conclave Created
Chairman (#31): deepseek/deepseek-r1
Members:
  - #1: anthropic/claude-opus-4.5
  - #12: google/gemini-2.5-pro
  - #21: google/gemini-2.5-flash

> conclave_quick("What is the best approach for...")
[Uses your custom selection]

> conclave_reset
## Custom Conclave Cleared

設定

config.py を編集してカスタマイズします:

Conclave階層

各階層には、適切な価格/パフォーマンスの差別化のために、重複のない独自のモデルが設定されています:

# Premium: 6 frontier models for complex questions (~$0.30-0.50/query)
COUNCIL_PREMIUM = [
    "anthropic/claude-opus-4.5",        # Claude Opus 4.5
    "google/gemini-3-pro-preview",      # Gemini 3 Pro
    "x-ai/grok-4",                      # Grok 4 (full reasoning)
    "openai/gpt-5.1",                   # GPT-5.1 (flagship)
    "deepseek/deepseek-v3.2-speciale",  # DeepSeek V3.2 Speciale
    "moonshotai/kimi-k2-thinking",      # Kimi K2 Thinking (1T MoE)
]

# Standard: 4 balanced models (default) (~$0.10-0.20/query)
COUNCIL_STANDARD = [
    "anthropic/claude-sonnet-4.5",      # Claude Sonnet 4.5
    "google/gemini-2.5-pro",            # Gemini 2.5 Pro
    "openai/o4-mini",                   # OpenAI o4-mini
    "deepseek/deepseek-chat-v3.1",      # DeepSeek Chat V3.1
]

# Budget: 4 cheap/fast models (~$0.02-0.05/query)
COUNCIL_BUDGET = [
    "google/gemini-2.5-flash",          # Gemini 2.5 Flash
    "qwen/qwen3-235b-a22b:free",        # Qwen 3 235B (free tier)
    "openai/gpt-4.1-mini",              # GPT-4.1 Mini
    "moonshotai/kimi-k2:free",          # Kimi K2 (free tier)
]

議長ローテーション

議長プールには、高品質な統合のために(チャットモデルではなく)推論モデルのみが使用されます:

CHAIRMAN_ROTATION_ENABLED = True
CHAIRMAN_ROTATION_DAYS = 7  # Rotate weekly

CHAIRMAN_POOL = [
    "deepseek/deepseek-r1",          # DeepSeek R1 reasoning
    "openai/o3-mini",                # OpenAI o3-mini reasoning
    "anthropic/claude-sonnet-4",     # Claude Sonnet 4 (strong reasoning)
    "qwen/qwq-32b",                  # Qwen QWQ reasoning model
]

合意しきい値

CONSENSUS_STRONG_THRESHOLD = 0.75   # 75%+ agreement
CONSENSUS_MODERATE_THRESHOLD = 0.50  # 50-75% agreement
CHAIRMAN_TIEBREAKER_ENABLED = True   # Chairman breaks ties

Eval-Light

階層間および長期的なConclaveのパフォーマンスをテスト・比較するためのスタンドアロン型ベンチマーク実行ツールです。

テストスイートの概要

評価スイートには、異なるモデル能力をテストするために設計された、9カテゴリにわたる 16のタスク が含まれています:

カテゴリ

タスク数

難易度

テスト内容

math

2

初級-中級

算数、文章題、ステップバイステップの推論

code

2

初級-中級

バグ検出、概念説明、コード例

reasoning

2

中級-上級

三段論法、多段階論理パズル

analysis

2

中級

論理的誤謬、トレードオフ分析

summarization

2

中級

技術文書、ビジネスレポート

writing_business

2

初級-中級

ビジネスメール、提案書

writing_creative

2

初級-中級

物語の書き出し、独自の比喩

creative

1

初級

解説付きの類推

factual

1

初級

一般向けの科学解説

評価の実行

# Run all 16 tests at standard tier (default)
python eval.py

# Run at different tiers
python eval.py --tier premium    # 6 frontier models (~$0.30-0.50/query)
python eval.py --tier standard   # 4 balanced models (~$0.10-0.20/query)
python eval.py --tier budget     # 4 cheap/fast models (~$0.02-0.05/query)

# Different modes
python eval.py --mode quick      # Stage 1 only (fastest, cheapest)
python eval.py --mode ranked     # Stage 1 + 2 (adds peer rankings)
python eval.py --mode full       # All 3 stages (default, includes synthesis)

# Filter by category
python eval.py --category math
python eval.py --category code
python eval.py --category reasoning

# Don't save results to disk
python eval.py --no-save

# Combine options
python eval.py --tier premium --mode full --category reasoning

出力形式

結果は evals/eval_<tier>_<mode>_<timestamp>.json に保存され、以下が含まれます:

  • metadata: タイムスタンプ、階層、モード、議長モデル

  • summary: 成功率、合計時間、タスクごとの平均時間

  • results: タスクごとの詳細(以下を含む):

    • 個別のモデル回答

    • ピアランキング(ranked/fullモードの場合)

    • 議長による統合(fullモードの場合)

    • 合意レベル

出力例

🏛️  Conclave Eval-Light
   Tier: standard | Mode: full | Tasks: 16
--------------------------------------------------

[1/16] Running: math_arithmetic (math)
   ✓ Completed in 12.34s

[2/16] Running: math_word_problem (math)
   ✓ Completed in 15.67s
...

==================================================
📊 EVAL SUMMARY
==================================================
Tier: standard | Mode: full
Chairman: deepseek/deepseek-r1
Tasks: 16/16 successful
Total time: 287.45s
Avg per task: 17.97s

📋 Results by Task:
  ✓ math_arithmetic (easy) - 12.34s
  ✓ math_word_problem (medium) - 15.67s
  ✓ code_debug (easy) - 11.23s
  ...

💾 Results saved to: evals/eval_standard_full_20251204_143052.json

階層の比較

すべての階層で同じ評価を実行し、モデルの品質とコストを比較します:

python eval.py --tier budget --category reasoning
python eval.py --tier standard --category reasoning
python eval.py --tier premium --category reasoning

その後、JSON出力を比較して、同じタスクに対して異なるモデル階層がどのように機能するかを確認します。

ユースケース

シナリオ

推奨ツール

理由

「この関数をレビューして」

conclave_ranked

どのモデルが最も多くの問題を指摘するかを確認

「セッション管理にRedisとPostgreSQLどちらが良い?」

conclave_full

重要な決定のため、統合が必要

「この機能のアイデア出し」

conclave_quick

高速で多様なブレインストーミング

「このエラーをデバッグして」

conclave_quick

高速な並列診断

「この段落を書き直して」

conclave_full + chairman_preset="creative"

クリエイティブな統合

「このアーキテクチャは健全か?」

conclave_full + chairman_preset="code"

技術的な統合

ツール出力例

## Conclave Full Result

**Consensus: ✅ STRONG** (75% agreement)

---

### Chairman's Synthesis

_Chairman: deepseek/deepseek-r1_

[Synthesized answer incorporating best points from all models...]

---

### Model Rankings (lower is better)

1. **claude-sonnet-4.5**: 1.50
2. **o4-mini**: 2.00
3. **gemini-2.5-pro**: 2.75
4. **deepseek-v3.1**: 3.75

_First-place votes:_ claude-sonnet-4.5=3, o4-mini=1

プロジェクト構造

conclave-mcp/
├── server.py      # MCP server entry point (5 tools)
├── conclave.py    # Core 3-stage council logic
├── config.py      # Model tiers, chairman rotation, cost estimates
├── eval.py        # Standalone benchmark runner
└── evals/         # Saved evaluation results

モデルの追加

OpenRouterは200以上のモデルをサポートしています。モデルIDは https://openrouter.ai/models で確認してください。

# Add to COUNCIL_* lists in config.py
"x-ai/grok-4"                    # xAI Grok
"meta-llama/llama-4-maverick"    # Meta Llama
"mistralai/mistral-large-2"      # Mistral
"deepseek/deepseek-r1"           # DeepSeek reasoning

重要: 適切な差別化のために、各階層のモデルは重複させないようにしてください。

OpenRouterの仕組み

OpenRouterは統合されたAPIゲートウェイです。OpenAI、Google、Anthropicなどの個別の契約は不要です。1つのAPIキーと1つのクレジット残高で、すべてのモデルにアクセスできます。

  • サインアップ: https://openrouter.ai

  • クレジットの追加(プリペイド、または自動チャージを有効化)

  • すべてのモデルに対して単一のAPIキーを使用

ライセンス

MIT

帰属

Andrej Karpathy氏のllm-councilに着想を得ています。オリジナルはLLMの比較をインタラクティブに探索するためのWebアプリケーションです。本プロジェクトは、AI支援エディタとの統合のために、その評議会コンセプトをMCPサーバーとして再実装し、合意プロトコルとタイブレーカーのメカニズムを追加したものです。

Available Tools

8 tools
conclave_configA

View current conclave configuration.

Shows conclave member models, current chairman with rotation info, available chairman presets, consensus thresholds, and API key status.

Also shows custom conclave selection if active.

Returns: Current configuration as formatted JSON

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It discloses that this is a read-only operation ('View') and describes the return format ('formatted JSON'), but lacks details on permissions, rate limits, or error behavior. It adds some context about what data is included, which is helpful but not comprehensive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core purpose, followed by specific details in bullet-like structure, and ends with return information. Every sentence adds value without redundancy, making it efficient and well-organized.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (configuration viewing with multiple data points), no annotations, and an output schema present, the description is mostly complete. It lists what data is shown and the return format, but could improve by mentioning sibling differentiation or behavioral constraints like authentication needs.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters with 100% schema description coverage, so no parameter documentation is needed. The description correctly doesn't discuss parameters, earning a high baseline score for not adding unnecessary information.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the specific action ('View current conclave configuration') and lists the exact resources it shows (member models, chairman info, presets, thresholds, API key status, custom selection). It distinguishes from siblings like 'conclave_estimate' or 'conclave_reset' by focusing on configuration viewing rather than estimation or resetting.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'conclave_models' (which might show models only) or 'conclave_full' (unclear purpose). It implies usage for viewing configuration but doesn't specify scenarios, prerequisites, or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

conclave_estimateA

Estimate cost for a conclave query before running it.

Provides approximate cost breakdown for quick/ranked/full query types.

Args: question: The question (used to estimate token count) tier: Which tier to estimate - "quick", "ranked", "full" (default: all)

Returns: Cost estimates for each query type

ParametersJSON Schema
NameRequiredDescriptionDefault
questionYes
tierNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses that the tool provides 'approximate cost breakdown' and estimates based on token count, which adds useful behavioral context. However, it doesn't mention potential limitations like accuracy, rate limits, or authentication needs, leaving gaps for a tool with no annotation coverage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and front-loaded: the first sentence states the core purpose, followed by brief elaboration. Every sentence adds value without redundancy, and the structure with 'Args:' and 'Returns:' sections enhances readability without unnecessary verbosity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 2 parameters with 0% schema coverage and an output schema present, the description is mostly complete. It explains parameters and return values ('Cost estimates for each query type'), but could benefit from more detail on behavioral aspects like error handling or prerequisites, especially since no annotations are provided.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It adds meaning beyond the schema by explaining that 'question' is 'used to estimate token count' and 'tier' specifies 'quick/ranked/full query types' with a default of 'all'. This clarifies parameter purposes, though it doesn't detail format constraints or examples.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Estimate cost for a conclave query before running it.' It specifies the verb ('estimate'), resource ('cost'), and scope ('before running it'), distinguishing it from sibling tools like conclave_quick or conclave_full that likely execute queries rather than estimate costs.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context for when to use this tool: 'before running it' implies it's for pre-execution cost estimation. However, it doesn't explicitly state when not to use it or name alternatives among siblings, such as comparing to conclave_config or conclave_select, which might have overlapping or related purposes.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

conclave_fullA

Run the full conclave with synthesis (all 3 stages).

Most comprehensive - collects opinions, peer rankings, then has a Chairman model synthesize the best possible answer from the collective wisdom.

If a custom conclave is active (via conclave_select), it will be used instead of the tier-based config. The custom chairman overrides the chairman and chairman_preset parameters.

Args: question: The question to ask the conclave tier: Model tier - "premium" (complex), "standard" (default), "budget" (simple) Ignored if custom conclave is active. chairman: Override chairman model (e.g., 'anthropic/claude-sonnet-4') Ignored if custom conclave is active. chairman_preset: Use a context-based preset - "code", "creative", "reasoning", "concise", "balanced" Ignored if custom conclave is active.

Returns: Chairman's synthesis, consensus level, rankings, and individual responses

ParametersJSON Schema
NameRequiredDescriptionDefault
questionYes
tierNostandard
chairmanNo
chairman_presetNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden and does well by explaining the multi-stage process ('collects opinions, peer rankings, then has a Chairman model synthesize'), the override behavior with custom conclaves, and what the tool returns. It doesn't mention rate limits, auth needs, or error conditions, but provides substantial behavioral context beyond basic functionality.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and front-loaded with the core purpose first. The Args and Returns sections are well-structured. Some sentences could be slightly more concise, but overall it's efficient with zero wasted text.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (multi-stage synthesis with overrides), no annotations, and 0% schema coverage, the description provides complete context. It explains the process, parameter semantics, conditional behavior, and return values. The output schema exists, so the description appropriately doesn't need to detail return structure.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage, the description fully compensates by explaining all 4 parameters in detail: what 'question' is for, the meaning of 'tier' values, what 'chairman' overrides, and the purpose of 'chairman_preset' options. It also clarifies conditional behavior ('Ignored if custom conclave is active') that isn't in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with specific verbs ('Run the full conclave with synthesis') and resources ('all 3 stages'), and distinguishes it from siblings by emphasizing it's the 'most comprehensive' option that includes synthesis. It explicitly mentions what makes it different from other conclave tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides explicit guidance on when to use this tool ('Most comprehensive') and when parameters are ignored ('Ignored if custom conclave is active'). It also implies alternatives through sibling tool names like conclave_quick and conclave_ranked, giving clear context for selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

conclave_modelsA

List all available models with selection numbers.

Shows all models from all tiers with unique numbers that can be used with conclave_select to create a custom conclave.

Numbers are stable:

  • Premium tier: 1-10

  • Standard tier: 11-20

  • Budget tier: 21-30

  • Chairman pool: 31-40

Returns: Numbered list of all available models grouped by tier

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden and does well by disclosing key behavioral traits: it lists models grouped by tier, specifies that numbers are stable with defined ranges per tier, and describes the return format as a numbered list. It doesn't mention aspects like rate limits or authentication needs, but covers essential behavior adequately for a read-only tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core purpose in the first sentence, followed by supporting details in bullet points and a returns section. Every sentence earns its place by adding specific information about tiers, number stability, and usage context without any redundant or vague statements.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (0 parameters, no annotations, but with an output schema), the description is complete. It explains the purpose, behavioral context (stable numbers per tier), usage with 'conclave_select', and return format. The output schema likely details the structure, so the description doesn't need to exhaustively list return values, making it well-rounded for this context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0 parameters with 100% coverage, so no parameter documentation is needed. The description appropriately focuses on output semantics, explaining the numbered list structure and tier groupings. This adds value beyond the schema by clarifying what the tool returns, which is helpful given the presence of an output schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'List' and resource 'all available models with selection numbers', specifying it shows models from all tiers with unique numbers. It distinguishes from siblings by mentioning these numbers are used with 'conclave_select' to create custom conclaves, providing specific differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context by explaining that the numbers are used with 'conclave_select' for custom conclave creation, giving a specific when-to-use scenario. However, it doesn't explicitly state when not to use this tool or compare it to alternatives like 'conclave_quick' or 'conclave_full', which could help further differentiate usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

conclave_quickA

Query the conclave for quick parallel opinions (Stage 1 only).

Fast and cheap - queries all conclave models in parallel and returns their individual responses. No peer ranking or synthesis. Good for getting diverse perspectives quickly.

If a custom conclave is active (via conclave_select), it will be used instead of the tier-based config.

Args: question: The question to ask the conclave tier: Model tier - "premium" (frontier), "standard" (default), "budget" (cheap/fast) Ignored if custom conclave is active.

Returns: Individual responses from each conclave model

ParametersJSON Schema
NameRequiredDescriptionDefault
questionYes
tierNostandard

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden and does well by disclosing key behavioral traits: it's 'Fast and cheap', queries 'all conclave models in parallel', returns 'individual responses' without synthesis, and mentions the interaction with conclave_select for custom conclaves. It doesn't cover rate limits, authentication needs, or error handling, but provides substantial operational context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is perfectly structured and concise: purpose statement first, key characteristics next, behavioral notes, then parameter details in labeled sections. Every sentence earns its place with no redundancy or fluff. The use of sections (Args, Returns) enhances readability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 2 parameters with 0% schema coverage and no annotations, the description does an excellent job explaining parameters and behavioral context. The existence of an output schema means it doesn't need to detail return values. It could mention more about error cases or prerequisites, but covers the essential context well for this query tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It adds meaningful semantics for both parameters: 'question' is described as 'The question to ask the conclave', and 'tier' gets detailed explanation of values ('premium', 'standard', 'budget') with defaults and the override rule when custom conclave is active. This goes well beyond the bare schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with specific verbs ('Query the conclave for quick parallel opinions') and distinguishes it from siblings by specifying 'Stage 1 only', 'Fast and cheap', 'No peer ranking or synthesis', and 'Good for getting diverse perspectives quickly'. It explicitly differentiates from tools like conclave_full or conclave_ranked that likely involve synthesis or ranking.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides explicit guidance on when to use this tool ('Good for getting diverse perspectives quickly') and when not to use it ('Stage 1 only', 'No peer ranking or synthesis'). It also mentions the alternative of using a custom conclave via conclave_select, though it could be more explicit about other sibling alternatives like conclave_full or conclave_ranked.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

conclave_rankedA

Query the conclave with peer rankings (Stage 1 + 2).

Medium cost - gets individual opinions, then has each model anonymously evaluate and rank all responses. Returns aggregate "street cred" scores showing which models performed best on this specific question.

If a custom conclave is active (via conclave_select), it will be used instead of the tier-based config.

Args: question: The question to ask the conclave tier: Model tier - "premium" (frontier), "standard" (default), "budget" (cheap/fast) Ignored if custom conclave is active.

Returns: Individual responses plus aggregate rankings

ParametersJSON Schema
NameRequiredDescriptionDefault
questionYes
tierNostandard

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It discloses key behavioral traits: the two-stage process (individual opinions then anonymous ranking), cost level ('medium cost'), and the effect of 'conclave_select'. However, it doesn't cover important aspects like rate limits, authentication needs, error handling, or what 'street cred' scores entail, leaving gaps for a tool with no annotation support.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and front-loaded, starting with the core purpose. The sentences are efficient, but the 'Args' and 'Returns' sections could be integrated more seamlessly, and some phrasing ('medium cost') is slightly vague, slightly reducing conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given complexity (multi-stage ranking process), no annotations, and an output schema present, the description is mostly complete. It covers the process, parameters, and return overview, but lacks details on output structure or error cases, which the output schema might handle, making it adequate but not fully comprehensive.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It explains 'question' as 'the question to ask the conclave' and 'tier' with values and default, adding meaning beyond the bare schema. However, it doesn't detail format constraints for 'question' or fully explain 'tier' implications beyond the list, resulting in partial compensation for the low coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool 'queries the conclave with peer rankings' and specifies it involves 'Stage 1 + 2' processing, which distinguishes it from simple query tools. However, it doesn't explicitly differentiate from siblings like 'conclave_full' or 'conclave_quick' in terms of ranking methodology, leaving some ambiguity about sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context for usage: it mentions 'medium cost' and explains when to use it (for getting individual opinions and aggregate rankings). It also notes that a custom conclave via 'conclave_select' overrides the tier parameter, offering some alternative guidance. However, it lacks explicit when-not-to-use scenarios or comparisons to specific siblings like 'conclave_estimate' or 'conclave_quick'.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

conclave_resetA

Clear custom conclave selection and return to tier-based config.

After reset, queries will use the tier parameter (premium/standard/budget) instead of the custom model selection.

Returns: Confirmation that custom selection was cleared

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden and does well by disclosing the behavioral outcome ('clear custom selection', 'return to tier-based config', 'queries will use tier parameter') and return value ('Confirmation that custom selection was cleared'), though it lacks details on permissions or side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is front-loaded with the core action in the first sentence, followed by outcome and return details in clear, efficient sentences. Every sentence adds value without waste, making it highly concise and well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (0 parameters, no annotations, but has output schema), the description is nearly complete by explaining the reset action, post-reset behavior, and return value. It could slightly improve by mentioning any prerequisites or errors, but covers essentials well.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters with 100% schema description coverage, so no parameter info is needed. The description appropriately focuses on behavior and output, earning a baseline 4 for not adding unnecessary details beyond the empty schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the specific action ('Clear custom conclave selection') and the resource affected ('tier-based config'), distinguishing it from siblings like conclave_config or conclave_select that likely configure or choose models rather than resetting to defaults.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It implicitly indicates usage context ('return to tier-based config') and the effect ('queries will use the tier parameter'), but does not explicitly state when to use this vs. alternatives like conclave_config or what triggers a reset need, missing explicit exclusions or prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

conclave_selectA

Create a custom conclave from model numbers.

Select specific models by their numbers (from conclave_models). The first model in the list becomes the chairman.

This custom selection persists until server restart or conclave_reset.

Args: models: Comma-separated model numbers, e.g. "1,5,11,14" First number = chairman, rest = conclave members

Returns: Confirmation of the new conclave configuration

Example: conclave_select(models="31,1,11,21") creates: - Chairman: model #31 (deepseek-r1) - Members: models #1, #11, #21

ParametersJSON Schema
NameRequiredDescriptionDefault
modelsYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden and does so well. It discloses key behavioral traits: the custom selection persists until server restart or conclave_reset, the first model becomes chairman, and it references sibling tools (conclave_models, conclave_reset) for context. It doesn't mention permissions, rate limits, or error handling, but covers persistence and structure adequately.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured and front-loaded with the core purpose, followed by usage details, persistence, args, returns, and an example. Every sentence adds value without redundancy, and the example efficiently illustrates the tool's behavior.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (custom conclave creation with persistence), no annotations, and an output schema present, the description is complete. It covers purpose, usage, parameters, behavioral traits, and includes an example, making it sufficient for an AI agent to understand and invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 0%, so the description must compensate, which it does excellently. It explains the 'models' parameter as comma-separated model numbers, specifies the first number is chairman and the rest are members, provides an example format, and clarifies the mapping to specific models (e.g., model #31 = deepseek-r1).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Create a custom conclave from model numbers' with specific actions like selecting models and designating a chairman. It distinguishes from siblings by focusing on custom selection rather than configuration, estimation, or resetting.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context for when to use this tool: to create a custom conclave from specific model numbers, with the first model as chairman. It mentions persistence until server restart or conclave_reset, but does not explicitly state when to use alternatives like conclave_quick or conclave_ranked.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 8 tool updatesv0.2.0
    • First observedconclave_config
    • First observedconclave_estimate
    • First observedconclave_full
    • First observedconclave_models
    • First observedconclave_quick
    • First observedconclave_ranked
    • First observedconclave_reset
    • First observedconclave_select

TDQS

A4.3/5.0

Scored across 8 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no ambiguity. For example, conclave_quick, conclave_ranked, and conclave_full represent distinct stages of query processing, while conclave_select and conclave_reset manage custom configurations, and conclave_models and conclave_config provide informational views. The descriptions clearly differentiate their roles.

Naming Consistency5/5

All tool names follow a consistent snake_case pattern with a 'conclave_' prefix and descriptive suffixes (e.g., conclave_config, conclave_estimate, conclave_full). This uniformity makes the tool set predictable and easy to understand, enhancing usability for agents.

Tool Count5/5

With 8 tools, the server is well-scoped for its purpose of managing and querying a conclave of models. Each tool serves a specific function, such as configuration, estimation, querying at different stages, and model selection, without redundancy or unnecessary complexity.

Completeness5/5

The tool set provides complete coverage for the conclave domain, including configuration viewing, cost estimation, querying at all stages (quick, ranked, full), model listing, custom selection, and resetting. There are no obvious gaps; agents can perform the full lifecycle from setup to querying and cleanup.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers