Conclave MCP
Conclave MCP
Un servidor MCP (Model Context Protocol) que proporciona acceso a un "cónclave" de modelos LLM, permitiendo que cualquier cliente compatible con MCP consulte múltiples modelos de vanguardia para obtener opiniones diversas, evaluaciones clasificadas por pares y respuestas sintetizadas.
Por qué existe esto
Cuando trabajas con un asistente de IA, obtienes la perspectiva de un solo modelo. A veces eso es exactamente lo que necesitas. Pero para decisiones importantes (arquitectura técnica, estrategia empresarial, dirección creativa, análisis complejos o cualquier situación donde los puntos ciegos importen), una pluralidad de opiniones revela alternativas que podrías pasar por alto.
Conclave lleva el consenso democrático de la IA a cualquier flujo de trabajo.
En lugar de consultar manualmente múltiples servicios de IA, puedes consultar el cónclave a través de Claude Desktop, Claude Code o cualquier cliente MCP. Obtén opiniones clasificadas de múltiples modelos de vanguardia (GPT, Claude, Gemini, Grok, DeepSeek) y recibe una respuesta sintetizada que representa la sabiduría colectiva de la IA.
Los casos de uso incluyen:
Técnico: Decisiones de arquitectura, revisión de código, depuración, diseño de API
Negocios: Análisis de estrategia, revisión de propuestas, síntesis de investigación de mercado
Creativo: Comentarios sobre escritura, lluvia de ideas, perspectivas editoriales
Investigación: Revisión bibliográfica, verificación de hechos, análisis multiperspectiva
Toma de decisiones: Análisis de pros/contras, evaluación de riesgos, evaluación de opciones
Inspirado en el concepto llm-council de Andrej Karpathy. Este proyecto reimplementa las ideas centrales como un servidor MCP para una integración fluida con flujos de trabajo asistidos por IA.
Related MCP server: AI Council MCP Server
Cómo funciona
El cónclave opera en hasta 3 etapas:
┌─────────────────────────────────────────────────────────────────┐
│ 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 │
└─────────────────────────────────────────────────────────────────┘Características
Consultas por niveles: Elige el equilibrio entre coste y profundidad (rápido | clasificado | completo)
Tres niveles de consejo: Premium (vanguardia), Estándar (equilibrado), Presupuesto (rápido/barato)
Protocolo de consenso: Detecta el nivel de acuerdo, activa el desempate en caso de división
Tamaño impar del cónclave: Asegura que los votos de desempate puedan romper bloqueos
Presidencia rotativa: La rotación semanal evita el sesgo de un solo modelo
Preajustes de presidente: Selección de presidente consciente del contexto (código, creativo, razonamiento)
Estimación de costes: Conoce lo que gastarás antes de consultar
Eval-light: Ejecutor de pruebas independiente para realizar un seguimiento del rendimiento a lo largo del tiempo
Instalación
Requisitos previos
Obtén una clave API de OpenRouter en https://openrouter.ai/keys
Añade créditos a tu cuenta de OpenRouter (pago por uso)
Configuración
# 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" > .envConfigurar Claude Desktop
Opción 1: Extensiones de escritorio (Recomendado)
Abre Claude Desktop
Ve a Settings > Extensions > Advanced settings > Install Extension...
Navega al directorio
conclave-mcpSigue las instrucciones para configurar tu
OPENROUTER_API_KEYReinicia Claude Desktop
Opción 2: Configuración manual
Abre Claude Desktop, ve a Settings > Developer > Edit Config y añade lo siguiente a 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"
}
}
}
}Reemplaza /path/to/conclave-mcp con tu ruta real, guarda y reinicia Claude Desktop.
Configurar Claude Code
Añade el servidor usando la 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-hereO copia .mcp.json.example a .mcp.json y actualiza las rutas:
cp .mcp.json.example .mcp.json
# Edit .mcp.json with your paths and API keyVerifica con /mcp en Claude Code o claude mcp list en la terminal.
Herramientas disponibles
conclave_quick
Opiniones paralelas rápidas (solo Etapa 1). Consulta todos los modelos del cónclave y devuelve respuestas individuales.
Coste: ~$0.01-0.03 por consulta
Uso para: Lluvia de ideas rápida, obtener perspectivas diversas rápidamente
conclave_ranked
Opiniones con clasificaciones por pares (Etapa 1 + 2). Muestra qué modelo tuvo el mejor desempeño en esta pregunta específica.
Coste: ~$0.05-0.10 por consulta
Uso para: Revisión de código, comparación de enfoques, ver qué modelo "ganó"
conclave_full
Cónclave completo con síntesis (las 3 etapas). Incluye detección de consenso y desempate del presidente.
Coste: ~$0.10-0.20 por consulta
Opciones:
tier: Nivel del modelo -"premium","standard"(predeterminado),"budget"chairman: Sobrescribir el modelo presidente (ej."anthropic/claude-sonnet-4")chairman_preset: Usar un preajuste ("code","creative","reasoning","concise","balanced")
Uso para: Decisiones importantes, elecciones de arquitectura, depuración compleja
conclave_config
Ver la configuración actual: miembros del cónclave, estado de rotación de la presidencia, umbrales de consenso.
conclave_estimate
Estimar costes antes de ejecutar una consulta.
conclave_models
Listar todos los modelos disponibles con números de selección. Muestra modelos agrupados por nivel con numeración estable:
Nivel Premium: 1-10
Nivel Estándar: 11-20
Nivel Presupuesto: 21-30
Grupo de presidencia: 31-40
conclave_select
Crear un cónclave personalizado a partir de números de modelo. El primer modelo se convierte en el presidente.
conclave_select(models="31,1,11,21")Crea:
Presidente: #31 (deepseek-r1)
Miembros: #1 (claude-opus-4.5), #11 (claude-sonnet-4.5), #21 (gemini-2.5-flash)
La selección personalizada persiste hasta reiniciar el servidor o ejecutar conclave_reset.
conclave_reset
Borrar la selección personalizada del cónclave y volver a la configuración basada en niveles.
Selección de modelo personalizada
Para un control total sobre qué modelos participan en el cónclave:
Listar modelos disponibles: Usa
conclave_modelspara ver todos los modelos con sus númerosSelecciona tu alineación: Usa
conclave_select(models="31,1,11,21")- el primer número es el presidenteConsulta: Usa
conclave_quick,conclave_rankedoconclave_fullnormalmenteRestablecer: Usa
conclave_resetpara volver a la configuración basada en niveles
Ejemplo de flujo de trabajo:
> 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 ClearedConfiguración
Edita config.py para personalizar:
Niveles del cónclave
Cada nivel tiene modelos únicos (sin superposición) para una diferenciación adecuada de precio/rendimiento:
# 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)
]Rotación de la presidencia
El grupo de presidencia utiliza solo modelos de razonamiento (no modelos de chat) para una síntesis de alta calidad:
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
]Umbrales de consenso
CONSENSUS_STRONG_THRESHOLD = 0.75 # 75%+ agreement
CONSENSUS_MODERATE_THRESHOLD = 0.50 # 50-75% agreement
CHAIRMAN_TIEBREAKER_ENABLED = True # Chairman breaks tiesEval-Light
Un ejecutor de pruebas independiente para probar y comparar el rendimiento del cónclave entre niveles y a lo largo del tiempo.
Resumen del conjunto de pruebas
El conjunto de evaluación incluye 16 tareas en 9 categorías, diseñadas para probar diferentes capacidades del modelo:
Categoría | Tareas | Dificultad | Qué prueba |
math | 2 | Fácil-Media | Aritmética, problemas verbales, razonamiento paso a paso |
code | 2 | Fácil-Media | Detección de errores, explicación de conceptos, ejemplos de código |
reasoning | 2 | Media-Difícil | Silogismos, acertijos lógicos de varios pasos |
analysis | 2 | Media | Falacias lógicas, análisis de compensaciones |
summarization | 2 | Media | Documentos técnicos, informes comerciales |
writing_business | 2 | Fácil-Media | Correos electrónicos profesionales, propuestas |
writing_creative | 2 | Fácil-Media | Inicios de historias, metáforas originales |
creative | 1 | Fácil | Analogías con explicaciones |
factual | 1 | Fácil | Explicaciones científicas para público general |
Ejecución de evaluaciones
# 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 reasoningFormato de salida
Los resultados se guardan en evals/eval_<tier>_<mode>_<timestamp>.json con:
metadatos: Marca de tiempo, nivel, modo, modelo presidente
resumen: Tasa de éxito, tiempo total, tiempo promedio por tarea
resultados: Detalles por tarea incluyendo:
Respuestas individuales del modelo
Clasificaciones por pares (para modos clasificado/completo)
Síntesis del presidente (para modo completo)
Nivel de consenso
Ejemplo de salida
🏛️ 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.jsonComparación de niveles
Ejecuta la misma evaluación en todos los niveles para comparar la calidad del modelo frente al coste:
python eval.py --tier budget --category reasoning
python eval.py --tier standard --category reasoning
python eval.py --tier premium --category reasoningLuego compara las salidas JSON para ver cómo funcionan los diferentes niveles de modelo en las mismas tareas.
Casos de uso
Escenario | Herramienta recomendada | Por qué |
"Revisa esta función" |
| Ver qué modelo detecta más problemas |
"¿Redis o PostgreSQL para sesiones?" |
| Decisión importante, necesita síntesis |
"Ideas para esta función" |
| Lluvia de ideas rápida y diversa |
"Depura este error" |
| Diagnóstico paralelo rápido |
"Reescribe este párrafo" |
| Síntesis creativa |
"¿Es sólida esta arquitectura?" |
| Síntesis técnica |
Ejemplo de salida de herramienta
## 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=1Estructura del proyecto
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 resultsAñadir modelos
OpenRouter admite más de 200 modelos. Encuentra los ID de modelo en 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 reasoningImportante: Mantén los modelos de cada nivel únicos (sin superposición) para una diferenciación adecuada.
Cómo funciona OpenRouter
OpenRouter es una puerta de enlace API unificada: no necesitas cuentas separadas con OpenAI, Google, Anthropic, etc. Una clave API, un saldo de crédito, acceso a todos los modelos.
Regístrate: https://openrouter.ai
Añade créditos (prepago o activa la recarga automática)
Usa tu única clave API para todos los modelos
Licencia
MIT
Atribución
Inspirado en llm-council de Andrej Karpathy. El original es una aplicación web para explorar interactivamente comparaciones de LLM. Este proyecto reimplementa el concepto de consejo como un servidor MCP para la integración con editores asistidos por IA, añadiendo un protocolo de consenso y mecanismos de desempate.
Available Tools
8 toolsconclave_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
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| question | Yes | ||
| tier | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| question | Yes | ||
| tier | No | standard | |
| chairman | No | ||
| chairman_preset | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| question | Yes | ||
| tier | No | standard |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| question | Yes | ||
| tier | No | standard |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| models | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
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.
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.
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.
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.
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.
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.
8 tool updates
v0.2.0- First observed
conclave_config - First observed
conclave_estimate - First observed
conclave_full - First observed
conclave_models - First observed
conclave_quick - First observed
conclave_ranked - First observed
conclave_reset - First observed
conclave_select
TDQS
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Multi-LLM council: 25+ frontier models in parallel, consensus scoring, verdict-first code review.
Convene a panel of expert AI personas to debate any decision from every side.
Consensus 'best X for Y' rankings from ChatGPT, Claude, Gemini & Grok. Search, verdicts, history.
A second opinion for AI agents: one prompt across several live Gonka models + roles, one call.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to create council hearings where multiple LLMs (Claude, GPT, Gemini, Grok) debate topics and synthesize verdicts with trust scores and diverse perspectives.25 npmApache 2.0
- AlicenseAqualityDmaintenanceMulti-AI Consensus Tool: Query multiple AI models in parallel, synthesize responses for better accuracy, and reduce AI bias through ensemble decision-making.131MIT
- AlicenseAqualityAmaintenanceEnables Claude to chat with various AI models and obtain multi-model consensus for complex decisions.3585 npm2MIT
- AlicenseAqualityDmaintenanceEnables querying multiple AI models in parallel (Claude, Gemini, O3) and synthesizing their responses using anonymous analysis to reduce bias, providing a comprehensive answer.145 npm193MIT