Conclave MCP

Instructions

Implementation Reference

• server.py:275-337 (handler)

  The conclave_config tool handler function. It retrieves and formats the current conclave configuration including API key status, active conclave (custom or tier-based), chairman rotation info, consensus thresholds, and available presets. Returns formatted JSON output.

  @mcp.tool()
  async def conclave_config() -> str:
      """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
      """
      rotation_info = get_rotation_info()
  
      # Check for custom conclave
      custom_models, custom_chairman, source = get_active_models()
  
      if source == "custom":
          size_validation = validate_council_size(custom_models, custom_chairman)
          active_config = {
              "mode": "custom",
              "chairman": custom_chairman,
              "members": custom_models,
              "size": {
                  "total_members": size_validation["total_size"],
                  "is_odd": size_validation["valid"],
                  "status": size_validation["message"],
              },
          }
      else:
          size_validation = validate_council_size()
          active_config = {
              "mode": "tier-based",
              "default_tier": "standard",
              "active_models": COUNCIL_MODELS,
              "size": {
                  "total_members": size_validation["total_size"],
                  "is_odd": size_validation["valid"],
                  "chairman_in_conclave": size_validation["chairman_included"],
                  "status": size_validation["message"],
              },
          }
  
      config = {
          "api_key_configured": bool(OPENROUTER_API_KEY),
          "active_conclave": active_config,
          "tiers": get_tier_info(),
          "chairman": {
              "current": custom_chairman if source == "custom" else rotation_info["current_chairman"],
              "rotation_enabled": rotation_info["rotation_enabled"] if source != "custom" else False,
              "rotation_period_days": rotation_info["rotation_period_days"],
              "days_until_rotation": rotation_info["days_until_rotation"] if source != "custom" else "N/A (custom)",
              "chairman_pool": rotation_info["chairman_pool"],
          },
          "consensus": {
              "strong_threshold": f"{CONSENSUS_STRONG_THRESHOLD:.0%}",
              "moderate_threshold": f"{CONSENSUS_MODERATE_THRESHOLD:.0%}",
              "tiebreaker_enabled": CHAIRMAN_TIEBREAKER_ENABLED,
          },
          "presets": CHAIRMAN_PRESETS,
      }
  
      return f"## Conclave Configuration\n\n```json\n{json.dumps(config, indent=2)}\n```"

• server.py:95-112 (helper)

  Helper function used by conclave_config to determine if a custom conclave is active or if the default tier-based configuration should be used.

  def get_active_models() -> tuple[list[str], str | None, str]:
      """
      Get the currently active models and chairman.
  
      Returns:
          (models, chairman, source) where source is "custom" or "tier"
      """
      global _custom_conclave
  
      if _custom_conclave:
          return (
              _custom_conclave["models"],
              _custom_conclave["chairman"],
              "custom"
          )
  
      # Default to standard tier
      return (COUNCIL_STANDARD, None, "tier")