QuantConnect MCP Server

Instructions

Implementation Reference

• quantconnect_mcp/src/tools/auth_tools.py:97-135 (handler)

  Handler function implementing the get_auth_status MCP tool. Uses get_auth_instance() to check authentication status and returns detailed status information including configuration details or setup instructions.

  @mcp.tool()
  async def get_auth_status() -> Dict[str, Any]:
      """
      Get current authentication status and configuration.
  
      Returns:
          Dictionary containing authentication status information
      """
      try:
          auth = get_auth_instance()
  
          if auth is None:
              return {
                  "status": "not_configured",
                  "authenticated": False,
                  "message": "QuantConnect authentication not configured",
                  "required_credentials": [
                      "user_id - Your QuantConnect user ID",
                      "api_token - Your QuantConnect API token",
                      "organization_id - Your organization ID (optional)",
                  ],
                  "setup_instructions": "Use configure_quantconnect_auth tool to set up credentials",
              }
  
          return {
              "status": "configured",
              "user_id": auth.user_id,
              "organization_id": auth.organization_id,
              "has_organization": auth.organization_id is not None,
              "api_base_url": auth.base_url,
              "message": "Authentication configured - use validate_quantconnect_auth to test",
          }
  
      except Exception as e:
          return {
              "status": "error",
              "error": str(e),
              "message": "Failed to get authentication status",
          }

• quantconnect_mcp/main.py:46-52 (registration)

  Top-level registration call to register_auth_tools(mcp), which defines and registers the get_auth_status tool among other auth tools to the MCP server instance.

  safe_print("🔧 Registering QuantConnect tools...")
  register_auth_tools(mcp)
  register_project_tools(mcp)
  register_file_tools(mcp)
  register_backtest_tools(mcp)
  register_live_tools(mcp)
  register_optimization_tools(mcp)